MultiTEL
Geliştiriciler

GET/v3/get_document_number_types/{country}

Kayıt için numara türlerini listeleme

Bir ülkenin kayıt kataloğunda şu anda yer alan numara türlerinin adlarını bulun.

Bu sayfada
  1. Döndürülen adına göre bir tür seçin
  2. Grup sayıları numara envanterini göstermez
  3. İstek
  4. Yanıt
  5. Hatalar
  6. Kullanılabilirlik ve yan etkiler

Döndürülen adına göre bir tür seçin

Şu kaynaktan bir ülke kullanın: get_document_countries. Döndürülen tür adını şu işleve iletin: get_requirements. Türün katalog kimliği; önek kimliği, numara kimliği veya kanıt belgesi kategorisi kimliği değildir.

Grup sayıları numara envanterini göstermez

available_groups bu katalog sorgusunun döndürdüğü grup kayıtlarını sayar. Satın alınabilir telefon numaralarını saymaz, stok ayırmaz ve kataloğun üst kaynaktaki tüm sayfaları taradığını garanti etmez. İlgili numara envanterinde arama yapın ve ayrıca bir fiyat teklifini inceleyin.

İstek

Etkin API hesabınızın kimlik bilgilerini HTTPS üzerinden kullanın. Basic kimlik doğrulaması ve etkinleştirilmiş API hesabı bearer belirteçleri desteklenir; hesap kısıtlamaları geçerlidir.

Belgelenmiş herhangi bir parametreyi URL yoluna ekleyerek GET isteği gönderin.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"
Yol parametreleri
AdTürZorunluAçıklama
countrystringEvetKayıt yapılabilen ülkeler kataloğundan alınan iki harfli ülke ISO kodu. Başındaki ve sonundaki boşluklar kaldırılır ve harfleri büyük harfe dönüştürülür.

Yanıt

JSON gövdesindeki status.code değerini ve HTTP durumunu kontrol edin. response, id, name ve available_groups alanlarını içeren bir dizidir. name değerini number_type olarak get_requirements çağrısında kullanın; onun yerine id göndermeyin. available_groups, o tür için döndürülen grup kayıtlarının sayısıdır; telefon numarası stok adedi veya sayfalandırılmış sonuçların tamamının toplamı değildir. Hiç grup döndürülmeyen türler yanıta dahil edilmez. Tercih edilen sıralama Local, Mobile, National, Toll Free, Shared Cost, Global şeklindedir; bunları diğer katalog adları izler.

Örnek yanıt yapısıdır; canlı hesap verisi veya güncel bir fiyat teklifi değildir.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Hatalar

  • 400: country is required: kayıt yapılabilen ülkenin ISO kodunu belirtin.
  • 400: Invalid country ISO or no available DID registration country found: güncel kayıt kataloğundan bir ülke seçin; bu hata, hiçbir belge gerekmediğini göstermez.

Kullanılabilirlik ve yan etkiler

  • Bu katalog/gereksinim sorgusu kimlik oluşturmaz, kanıt belgesi yüklemez, numara kaydetmez veya sipariş vermez.
  • Başarılı bir katalog yanıtı, belgelerinizin onaylandığı veya seçilen bir numaranın etkinleştirilebileceği anlamına gelmez.