Telefon numarası için rehber kaydı gönderme

Operatöre rehber kaydı gönderme

MultiTEL'de sahibi olduğunuz ve bu işlem için uygun olan bir telefon numarasının rehber kaydında kullanılacak adı ve adresi gönderin. Bu, ücretli bir operatör güncellemesidir; arayan adı sorgulaması, özel adres defteri kaydı veya portalın envanterindeki LIDB alanının genel güncellemesi değildir.

Yalnızca müşterinin rehber kaydı için kullanılmasına izin verdiği bilgileri gönderin. Bu eski uç noktayı kullanmadan önce operatörün söz konusu numarayı desteklediğini doğrulayın. İncelenen işleyici, sağlayıcı uygunluğunu veya uluslararası numara biçimini doğrulamaz; operatöre gönderdiği istekte numaranın Kuzey Amerika numarası olduğunu varsayar ve kayıtlı ilk rakamı kaldırır.

Hesap ve numara gereksinimleri

İzin verilen bir kaynak IP adresinden, HTTPS üzerinden etkin bir API hesabı kullanın. Numaranın tam olarak bu hesaba ait, geçersiz kılınmamış bir satın alınan numara satırında bulunması gerekir. Envanterinizdeki uluslararası numaranın tüm rakamlarını kullanın; örneğin, desteklenen bir Kuzey Amerika numarası için ülke kodu 1 olan biçimi kullanın. Tarife planı kimliği, numaranın UUID değeri veya başka bir hesaba ait numara kullanmayın.

Form verileriyle POST isteği

Sahibi olduğunuz numarayı NUMBER alanına girin. Kurgusal örneği, kullanımı için izin verilen rehber bilgileriyle değiştirin. Bu uç nokta form alanlarını POST isteğinden okur; application/json gövdesini ayrıştırmaz.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

Örnekteki yönler ve adres yer tutucudur; önerilen bir posta adresi değildir. Gerçek müşteri verilerine kurgusal bir yön eklemeyin. API tarafından yapılan zorunlu alan kontrolleri yüzeyseldir: adresin geçerli olduğunu veya operatör tarafından kabul edildiğini doğrulamaz; ayrıca eski web sitesinde farklı form gereksinimleri uygulanıyordu.

Uygulama, isteğe bağlı bir yön bileşeni eksik veya boş olduğunda eksik dizi anahtarı uyarısı verebilir. Yanıtın biçimi bozuksa veya operatör adresi reddederse, tahmine dayalı olarak değiştirilmiş adresleri tekrar tekrar göndermek yerine istek referansını saklayın ve destek ekibinden rehber kaydını doğrulamasını isteyin.

Ücretlendirme ve yeniden deneme davranışı

İncelenen işleyici, en az 10.00 bakiye birimi bulunduğunu operatörle iletişime geçmeden önce kontrol eder. Hem operatör hem de yerel numara güncellemesi başarı bildirdikten sonra 10.00 tutarını hesap bakiyesinden düşer ve rehber kurulumu için bir işlem kaydı oluşturur. Bunlar yeni bir fiyatlandırma önerisi değil, sistemde şu anda uygulanan tutarlardır; göndermeden önce geçerli faturalandırma para birimini ve desteklenen hizmeti hesap koşullarınızdan doğrulayın.

Bu işlemde idempotans anahtarı, yinelenen siparişleri önleyen bir koruma veya operatöre gönderimi, yerel güncellemeyi ve faturalandırmayı kapsayan bir veritabanı işlemi yoktur. Başarılı olan yinelenmiş bir istek, operatöre yeniden gönderime ve yeniden ücret alınmasına yol açabilir. Zaman aşımı veya API hatası, operatörün önceki isteği reddettiğini kanıtlamaz: sağlayıcı, yerel güncelleme başarısız olmadan önce isteği kabul etmiş olabilir.

Yanıt

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

Normal başarı yanıtında boş dize değerine sahip bir response alanı bulunur; rehber kaydı kimliği veya tamamlanma ayrıntıları döndürülmez. Bu, operatör ve yerel güncelleme yollarının başarı bildirdiği anlamına gelir; kaydın tüm harici rehberlerde yayımlandığını, hemen yayıldığını veya ileride arayan kimliği olarak görüntüleneceğini kanıtlamaz.

Eski sistem hataları

Hem HTTP durumunu hem de JSON içindeki şu alanları okuyun: status.code/status.msg. Kimlik doğrulama ve kaynak IP kısıtlamaları da kullanılabilir bir yanıt alınmasını engelleyebilir. Eski işleyicide açık bir HTTP yöntemi denetimi bulunmaması, güncelleme istemek için GET veya sorgu parametreleri kullanmanız için gerekçe değildir; bunları kullanmayın.

Yeniden denemeden önce doğrulayın

1. İsteği göndermeden önce sahibi olduğunuz numarayı, operatör uygunluğunu, kullanımı için izin verilen rehber verilerini ve ücreti doğrulayın.
2. Bir kez gönderin ve müşterinin adresini herkese açık günlüklere veya analiz sistemlerine aktarmadan hesap tarafındaki sonucu saklayın.
3. Kaydedilen rehber kaydını ve işlem geçmişini, desteklenen hesap iş akışı üzerinden veya destek ekibi aracılığıyla kontrol edin. Operatörün doğruladığı işlem süresinin dolmasını bekleyin; bu API, verilerin yayılması için garantili bir son tarih tanımlamaz.
4. Sonuç belirsizse, yeniden denemeden önce destek ekibinden operatör siparişi ile yerel faturalandırma kayıtlarını karşılaştırıp uzlaştırmasını isteyin. Yinelenen bir istek, idempotent bir durum kontrolü değildir.