Alegeți un prefix acceptat
Utilizați un prefix mobil individual actual din descoperire. Acest punct final este destinat centralelor NANPA: un NPA identifică indicativul de zonă, iar un NXX identifică centrala. Un prefix format doar din indicativul de zonă este prea larg. Nu trimiteți ID-uri de afișare grupate și nu deduceți acceptarea pentru altă țară doar pentru că prefixul acesteia conține suficiente cifre.
Utilizați numărul ca indicație
Citiți response.count, cu response.npa și response.nxx identificând centrala. Acesta este un instantaneu al serviciului de acoperire, nu un stoc păstrat pentru contul dumneavoastră. Confirmați numerele reale, ofertele aplicabile și orice cerințe de înregistrare înainte de a comanda. Un număr reușit nu autorizează niciodată o cumpărare.
Distingeți stocul zero de o căutare eșuată
Un număr reușit de zero diferă de o eroare API. Inspectați status.code și status.msg precum și starea HTTP. Tratați un timeout sau o căutare eșuată ca disponibilitate necunoscută și reîncercați mai târziu cu backoff.
Cerere
Utilizați datele de autentificare ale contului API activat prin HTTPS. Sunt acceptate autentificarea Basic și tokenurile bearer ale conturilor API activate; se aplică restricțiile contului.
GET cu identificatorul prefixului în calea URL. Nu există parametri de interogare sau de corp documentați.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
prefix_id | string | Da | Copiați ID-ul individual de prefix din răspunsul de descoperire. Utilizați un prefix mobil NANPA acceptat care conține un indicativ de zonă (NPA) și o centrală (NXX), nu un ID doar cu indicativ de zonă și nici un ID de rezumat grupat. Tratați identificatorul ca opac. |
Răspuns
Verificați status.code în corpul JSON precum și starea HTTP. Un response reușit are status.code 200 și status.msg Results. response este un obiect, nu o listă: count este un număr întreg care reprezintă un instantaneu al stocului; npa și nxx sunt șiruri de trei caractere. status.results nu este prezent pentru acest obiect asociativ. Un număr de 0 înseamnă că interogarea de acoperire nu a găsit o centrală corespunzătoare sau a returnat stoc zero; nu dovedește că toți furnizorii sau alte rute de descoperire nu au numere.
Formă ilustrativă de răspuns; nu date de cont în timp real și nici o ofertă actuală.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Erori
- 404: Furnizor dezactivat: acoperirea stocului de numere mobile este indisponibilă pe serviciu.
- 404: ID de prefix invalid: obțineți un ID individual de prefix actual din descoperire.
- 404: Prefix invalid: prefixul stocat nu conține suficiente cifre pentru o căutare NPA/NXX.
- 500: Acoperirea stocului a eșuat: căutarea din amonte nu a returnat un rezultat de acoperire reușit. Reîncercați mai târziu cu backoff; un eșec nu este un număr de stoc zero.
Disponibilitate și efecte secundare
- Operațiunea verifică stocul și nu plasează o comandă, nu rezervă numere și nu debitează o sumă de cumpărare.
- Stocul se poate schimba imediat. Numărul de acoperire nu este ajustat pentru a promite posibilități de cumpărare specifice contului sau aceeași lungime ca răspunsul următoarei căutări de numere.
- O căutare contactează serviciul de acoperire și poate dura. Nu interogați repetat fiecare prefix și nu tratați un timeout/eroare ca stoc zero reușit.