Desteklenen bir ön ek seçin
Keşif aşamasından güncel, tek tek bir mobil ön ek kullanın. Bu uç nokta NANPA santralleri için tasarlanmıştır: NPA alan kodunu, NXX ise santrali belirtir. Yalnızca alan kodu içeren bir ön ek fazla geneldir. Gruplanmış görüntü kimlikleri göndermeyin ve başka bir ülkenin ön ekünde yeterli basamak bulunması nedeniyle o ülke için destek olduğunu varsaymayın.
Sayımı bir ipucu olarak kullanın
Şunu okuyun: response.count, ayrıca response.npa ve response.nxx alanları santrali belirtir. Bu, kapsama hizmetinin anlık görüntüsüdür; hesabınız için tutulan stok değildir. Sipariş vermeden önce gerçek numaraları, geçerli teklifleri ve varsa tüm kayıt gereksinimlerini doğrulayın. Başarılı bir sayım asla satın alma yetkisi vermez.
Sıfır stoğu başarısız bir sorgudan ayırt edin
Sıfır değerindeki başarılı bir sayım, API hatasından farklıdır. Şunları inceleyin: status.code ve status.msg alanlarının yanı sıra HTTP durumunu da kontrol edin. Zaman aşımını veya başarısız sorguyu bilinmeyen uygunluk olarak ele alın ve daha sonra denemeler arasında bekleyerek (backoff) yeniden deneyin.
İstek
HTTPS üzerinden etkinleştirilmiş API hesabı kimlik bilgilerinizi kullanın. Basic kimlik doğrulaması ve etkin API hesabı taşıyıcı (bearer) belirteçleri desteklenir; hesap kısıtlamaları geçerlidir.
URL yolunda ön ek tanımlayıcısı ile GET isteği gönderin. Belgelenmiş herhangi bir sorgu veya gövde parametresi yoktur.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
prefix_id | string | Evet | Keşif yanıtındaki tekil ön ek kimliğini kopyalayın. Alan kodu (NPA) ve santral (NXX) içeren desteklenen bir NANPA mobil ön eki kullanın; yalnızca alan kodu içeren veya gruplanmış özet bir kimlik kullanmayın. Tanımlayıcıyı opak bir değer olarak ele alın. |
Yanıt
JSON gövdesinde status.code alanını ve HTTP durumunu kontrol edin. Başarılı bir response yanıtında status.code 200 ve status.msg Results bulunur. response bir liste değil, nesnedir: count tam sayı türünde bir envanter anlık görüntüsüdür; npa ve nxx üç karakterlik dizelerdir. Bu ilişkisel nesnede status.results bulunmaz. 0 sayımı, kapsama sorgusunun eşleşen bir santral bulamadığını veya sıfır stok döndürdüğünü gösterir; tüm tedarikçilerin veya diğer keşif yollarının hiç numarası olmadığını kanıtlamaz.
Açıklayıcı yanıt biçimi; canlı hesap verisi veya güncel bir teklif değildir.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Hatalar
- 404: Sağlayıcı devre dışı: hizmette mobil envanter kapsaması kullanılamıyor.
- 404: Geçersiz ön ek kimliği: keşif aşamasından güncel bir tekil ön ek kimliği edinin.
- 404: Geçersiz ön ek: kayıtlı ön ek, NPA/NXX sorgusu için yeterli basamak içermiyor.
- 500: Envanter kapsaması başarısız oldu: yukarı akış sorgusu başarılı bir kapsama sonucu döndürmedi. Daha sonra denemeler arasında bekleyerek (backoff) yeniden deneyin; bir başarısızlık, sıfır stok sayımı anlamına gelmez.
Kullanılabilirlik ve yan etkiler
- İşlem envanteri kontrol eder; sipariş vermez, numara rezerve etmez ve satın alma tutarını borçlandırmaz.
- Stok anında değişebilir. Kapsama sayımı, hesaba özel satın alınabilirliği veya bir sonraki numara arama yanıtının uzunluğunu vaat edecek şekilde ayarlanmaz.
- Bir sorgu kapsama hizmetine başvurur ve zaman alabilir. Her ön eki tekrar tekrar sorgulamayın; bir zaman aşımını/hatayı başarılı sıfır stok olarak değerlendirmeyin.