Kullanılabilir mobil numaraları bulun

Mobil envanterin etkinleştirildiğini doğrulayın

Bu aramayı yalnızca müşteri hesabınız için mobil numara envanteri etkinleştirildikten sonra kullanın. Hesabın keşif iş akışı üzerinden güncel bir bireysel mobil ön ek edinin. Desteklenen yol, bu ön ek için kablosuz envanter ister. Eşleşen bir sabit hat yönlendirme-metaverisi kaydına bağlı değildir. Hesabınızın veya ön ekin etkin olup olmadığından emin değilseniz destek ekibiyle iletişime geçin.

Mevcut eski (legacy) yol, uygun olmayan her isteği güvenilir biçimde reddetmez. Mobil envanter etkinleştirilmemiş bir hesap, yanıt hâlâ info.is_mobile: 1 derken sıradan envanter alabilir. Bu etiketle ücretsiz arama (toll-free) ön eki de ücretsiz arama envanteri dalına ulaşabilir. Mobil hizmeti tanımlamak için yalnızca bu etiketi kullanmayın ve bu uç noktaya sıradan veya ücretsiz arama ön ekleri göndermeyin. Hesabın onaylanmış mobil kataloğunu ve etkin iş akışını kullanın.

Her numarayı kendi fiyat seçimiyle birlikte tutun

Her aday için number, info.uuid ile aynı girdinin price listesini birlikte tutun. Yanıt ayrıca ön ek/alan/ülke metaverisi, sözleşme koşulları ve kayıt kısıtlamaları içerir. Adaylar, ilk fiyat seçeneklerinin aylık fiyatına göre artan şekilde sıralanır; eşit fiyatlar için garantili kararlı bir sıra yoktur. Döndürülen numara kimliğini bir alan veya ön ek kimliğiyle değiştirmeyin ya da başka bir adayın fiyat kimliğiyle eşleştirmeyin.

Eksiksiz yanıt ek metaveri ve fiyat alanları içerebilir. Döndürülen features, kanal değerleri ve restrictions adayı tanımlar; aramaların, SMS'nin, MMS'nin veya faksın zaten kullanılabilir olduğunun garantisi değildirler. Hesap izinleri, kayıt ve seçilen hizmet planı geçerliliğini korur. Örnekteki yer tutucuları geçerli kimlikler veya fiyatlar olarak görmeyin.

Küçük bir pozitif adet kullanın

1 adetle başlayın. Normal sağlayıcı isteği, pozitif olmayan bir adedi 1'e normalize eder ve yukarı akış değerini 300'de sınırlar, ancak sonraki sonuç işleme hâlâ özgün girdiyi kullanır. Bu nedenle sıfır bir adet, yukarı akış envanterini isteyebilir ve aday döndürmeyebilir. Diğer eski dallar istenen sonuç sayısını tutarlı şekilde zorunlu kılmaz. Tek bir evrensel maksimuma güvenmeyin; negatif, kesirli veya sayısal olmayan değerler göndermeyin. Bu yol için desteklenen genel bir arama filtresi veya fiyat kimliği gövde parametresi belgelenmemiştir.

Stok eksikliğini arama başarısızlığından ayırt edin

Bir 404 yanıtı, kullanılamayan envanteri, devre dışı bırakılmış hizmeti, başarısız tedarikçi aramasını veya geçersiz katalog kayıtlarını temsil edebilir. Zaman aşımını veya sağlayıcı hatasını doğrulanmış sıfır stok yerine bilinmeyen kullanılabilirlik olarak ele alın. Uygun olduğunda seçimi yenileyin ve denemeler arasında bekleyerek (backoff) yeniden deneyin. Her exchange'i tekrar tekrar yoklamaktan kaçının. Ayrı mobil envanter sayısı uç noktası bir anlık ipucudur ve bu hesabın aday listesinin uzunluğuyla eşleşmek zorunda değildir.

Satın almadan önce yeniden kontrol edin

Arama, stok rezerve etmez. İncelenen dal, zaten satın alınmış numaraları hariç tutmaya çalışır, ancak başarısız bir yerel rezervasyon araması böyle bir adayı sonuçta bırakabilir. Kullanılabilirlik, sahiplik, onaylanmış fiyatlandırma ve kayıt, satın alma iş akışı tarafından kontrol edilmelidir. Korumalı satın alma isteğiyle güncel bir seçim kullanın ve yeniden denemeden önce herhangi bir belirsiz satın alma sonucunun ardından hesap envanterini uzlaştırın. Asla yalnızca bir aday döndürüldü diye satın alma yapmayın.

İstek

İzin verilen bir kaynak IP adresinden HTTPS üzerinden etkinleştirilmiş bir API hesabı kullanın. Mobil envanterin de müşteri hesabı için etkinleştirilmiş olması gerekir; yalnızca API kimlik doğrulaması bunu etkinleştirmez.

GET URL yolunda güncel bireysel ön ek tanımlayıcısı ve pozitif bir tam sayı adet ile. Adet belirtilmezse varsayılan 1'dir. Örneği 1 ile kullanın; bu yol, evrensel bir sonuç sınırını tutarlı şekilde doğrulamaz veya zorunlu kılmaz.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Yanıt

JSON gövdesinde HTTP durumunun yanı sıra status.code ve status.msg alanlarını inceleyin. Başarı durumunda response bir numara adayları listesidir, status.msg, Results: ifadesiyle başlar ve ardından döndürülen adet gelir ve status.results serileştirilmiş liste uzunluğudur. Aday fiyatları hesaba özeldir. Açıklayıcı kısaltılmış örnek, gerçek envanter veya tarife teklifi yerine yer tutucular kullanır. Numaralar artı işareti olmadan ülke kodunu içerir; tanımlayıcılar opak dizelerdir.

Açıklayıcı yanıt biçimi; canlı hesap verisi veya güncel bir teklif değildir.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Hatalar

• 404: Geçersiz ön ek kimliği, ülke veya alan: bireysel mobil ön ek seçimini yenileyin.
• 404: Numara bulunamadı: kullanılabilir stok olmaması, devre dışı hizmet, başarısız sağlayıcı araması, desteklenmeyen seçim veya hesap sınırlamaları anlamına gelebilir. Bu, yetkili bir sıfır envanter sayısının kanıtı değildir.

Kullanılabilirlik ve yan etkiler

• Arama bir numarayı kiralamaz veya rezerve etmez ve incelenen yol bir satın alma tutarını borçlandırmaz. Envanter sağlayıcısıyla iletişim kurar ve zaman alabilir.
• Başarılı aramalar, hesapla ilgili numara ve fiyat önbelleği girdilerini ve sorgu günlüklerini yazar. Bir aramayı yinelemek rezervasyon, fiyat kilidi veya satın alma değildir.
• Döndürülen fiyatlar, koşullar, kısıtlamalar ve yetenekler seçilen hesap ve numara için incelenmelidir. Bir özellik etiketi, aktivasyonu, mesajlaşma onayını veya test edilmiş hizmet işlevselliğini kanıtlamaz.