Numara kayıt profilini gönderin

Kaydedilmiş profili ve numarayı hazırlayın

Kaydedilmiş bir kayıt profilini satın alınmış bir numarayla ilişkilendirmek ve desteklenen operatör destekli numaralar için kayıt incelemesi istemek üzere bu iş akışını kullanın. Bu, tüm numara sağlayıcıları için genel bir etkinleştirme API'si değildir. İsteğin başarılı olması, belgelerin onaylandığını veya numaranın etkin olduğunu kanıtlamaz.

Etkinleştirilmiş bir MultiTEL API hesabını, yapılandırılmış kimlik bilgileri ve IP kısıtlamalarıyla HTTPS üzerinden kullanın. Hem silinmemiş profil hem de satın alınmış ve geçersiz kılınmamış numara hesabınıza ait olmalıdır.

1. Bir kayıt profili oluşturun veya mevcut bir profili seçin. Yerel profilin uuid değerini create_document yanıtından alıp saklayın; get_document aynı yerel referansı id olarak döndürür.
2. Operatör destekli gönderim için profilin kaydedilmiş kimlik ve adres referanslarına sahip olması gerekir. Göndermeden önce gerekli kanıtları ve destekleyici belgeleri ilgili iş akışları aracılığıyla ekleyin.
3. Numaranın ve profilin ilgili ülke ve numara gereksinimlerini karşıladığını kontrol edin. Kaydedilmiş bir profilin her numara için onaylı olduğunu varsaymayın.

İlişkilendirmeyi gönderin

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  --form-string document_uuid="$PROFILE_UUID" \
  --form-string service_description="Example customer support line" \
  https://api.multitel.net/v3/number_identity/12125550123

Yol, satın alınmış telefon numarasını içerir; numaranın UUID'sini, bir PBX dahili numarasını veya kimlik tanımlayıcısını içermez. İşleyici, numaradaki rakam olmayan karakterleri kaldırır. Ülke koduyla birlikte tam uluslararası numarayı kullanın. Örnek kurgusaldır ve kendi numaranızla ve kaydedilmiş yerel profil referansınızla değiştirilmelidir.

Çok parçalı isteklerde bir dizi için tekrarlanan onetime_files[] alanları kullanılır. Content-Type: application/json başlığıyla JSON isteği de kabul edilir; özellikleri form verileriyle birleştirilir. Yoldaki numara belirtilmediğinde istek verilerinde bir number değeri sağlanabilir. Belirsizliği önlemek için yukarıda gösterilen, numarayı açıkça içeren yolu tercih edin.

İlişkilendirme ile onayı birbirinden ayırın

Hem HTTP sonucunu hem de JSON status.code değerini okuyun. JSON hataları HTTP 200 ile gelebilir. Operatör destekli işlem başarılı olduğunda şu mesaj bildirilir: Address verification task created; awaiting carrier review. Bu örnekte kurgusal referanslar kullanılmıştır.

{
  "status": {
    "code": 200,
    "msg": "Address verification task created; awaiting carrier review."
  },
  "response": {
    "number": "+12125550123",
    "did_id": "11111111111111111111111111111111",
    "document_uuid": "0123456789abcdef0123456789abcdef",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "address_verification_id": "44444444444444444444444444444444",
    "verification_status": "pending",
    "verification_reference": null,
    "requirement_id": "55555555555555555555555555555555",
    "registration_details_id": "8516ac99dc60603295de7bdb6a153530"
  }
}

Sağlayıcıyla ilgili tanımlayıcılar maskelenmiş referanslardır; birbirinin yerine kullanılabilen yerel profil tanımlayıcıları değildir. document_uuid, gönderdiğiniz yerel profil referansı olarak kalır. Bu işleyicinin operatör destekli işlem yolunda registration_details_id, bu yerel referansın yeniden özetlenmiş değeridir; sonraki profil veya gönderim isteklerinde document_uuid yerine bu değeri kullanmayın.

Bazı tahsis edilmiş numaralarda operatör doğrulaması oluşturmak yerine yerel kimlik ilişkilendirmesi kullanılır. Bunların başarılı sonucu, boş bir response dizisiyle birlikte Identity associated. mesajıdır. Bu işlem bir operatör inceleme görevi oluşturmaz veya onay sağlandığı anlamına gelmez. Portalda, sağlayıcıları ele alma biçimi ve tekrarlanan gönderim kontrolleri bu uç noktadan farklı olan daha yeni bir ilişkilendirme iş akışı bulunur.

Yinelenen görevler oluşturmadan hataları ele alın

API kodu 400, numara veya profil referansının eksik olduğunu belirtir. 404 kodu, profilin veya numaranın hesap için kullanılamadığını ya da numaranın operatör envanterinde bulunmadığını belirtir. 422 kodu, eksik kimlik veya adres referanslarını, satıcı gereksinimlerini ya da operatör doğrulamasının reddedildiğini bildirebilir. Eksik geri çağrı yapılandırması 503 koduna, oluşturma sırasında bir aktarım hatası ise 502 koduna yol açabilir. Her hatayı aynı şekilde ele almak yerine mesajı ve varsa requirement_diagnostics bilgilerini okuyun.

Operatör destekli işlem yolu; gereksinim doğrulaması, geri çağrı yapılandırması kontrolleri veya görev oluşturma tamamlanmadan önce yerel kayıt bekleme bayraklarını güncelleyebilir. Bu nedenle bir hata, yerel durumun değişmediği anlamına gelmez; tek başına bir bekleme bayrağı da bir görevin var olduğunu kanıtlamaz. Bu bayrakları onayın veya isteğin teslim edildiğinin teyidi olarak kullanmayın.

Daha sonraki bir yerel veritabanı işlemi başarısız olsa bile sağlayıcı bir görevi kabul edebilir ve bu yardımcı işlev, başarı bildirmeden önce her yerel yazma işleminin sonucunu kontrol etmez. Bu işleyicide istemci idempotans parametresi veya yinelenen gönderimleri önleyen bir koruma yoktur. Zaman aşımı, hata veya belirsiz bir sonuçtan sonra numaranın kayıt geçmişini portalda kontrol edin veya yeniden göndermeden önce destek ekibiyle iletişime geçin. Yerel bir kaydın bulunmaması, tek başına sağlayıcının hiçbir şey almadığını kanıtlamaz.

Tek seferlik belge sınırlaması

İşleyici, onetime_files alanını kabul eder ve boş olmayan her dizeyi operatörün şifreli dosya ilişkisine iletir. Dosyaların sahibi olan hesabın yükleme satırlarını aramaz veya dışarıya sunulan maskelenmiş yükleme tanımlayıcılarını sağlayıcı dosya tanımlayıcılarına dönüştürmez. Çevrimdışı denetim, operatör tarafında başarılı eklemeyi değil, iletme davranışını doğrulamıştır.

Tek seferlik bir sözleşme iş akışını tamamlamak için create_encrypt_files tarafından döndürülen bir dosya tanımlayıcısının bu alana kopyalanabileceğini varsaymayın. Bir numara bu belgeleri gerektiriyorsa portalı kullanın veya desteklenen tanımlayıcı iş akışını MultiTEL ile teyit edin. Bu konu, uçtan uca doğrulanmış bir örnek değil, API incelemesinin henüz çözümlenmemiş bir parçasıdır.

Kayıt bilgilerini koruyun

Yalnızca numara için kullanmaya yetkili olduğunuz bilgi ve belgeleri gönderin. Profil ve doğrulama referanslarını doğru hesapla ilişkili tutun ve kayıt isteği verilerinin tamamını günlüğe kaydetmekten kaçının. Bu istek, önceki tüm kanıtları veya doğrulamaları silmez ya da bunların yerine geçmez. Operatör incelemesi, etkinleştirme ve verilerin saklanması ayrı süreçlerdir.