Verificați acoperirea tabelului de alocări
Verificați dacă un număr din America de Nord corespunde unui prefix din tabelul de alocări MultiTEL și obțineți orașul, statul și țara asociate. Aceasta este o căutare într-un tabel de prefixe. Nu confirmă că un abonat este activ, că un număr este atribuit, că aparține contului dumneavoastră sau că îl puteți comanda.
Cerere
Utilizați contul API activat și o adresă IP sursă autorizată. Exemplul folosește date de autentificare HTTP Basic din variabile de mediu și un număr fictiv. Nu este necesar un corp al cererii.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Utilizați de preferință un număr din America de Nord format din unsprezece cifre, care începe cu 1. Componenta care procesează cererea elimină caracterele care nu sunt cifre și adaugă 1 la începutul unei valori de intrare formate din zece cifre. Valorile cu alte lungimi sunt respinse. Această normalizare nu verifică toate regulile de numerotație din America de Nord, astfel că găsirea unei corespondențe în tabel nu reprezintă o validare exhaustivă a numărului.
Răspuns
Valorile câmpurilor sunt doar ilustrative; acesta nu este un rezultat obținut prin interogarea în timp real a tabelului de alocări.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Câmp | Semnificație |
|---|---|
| number | Valoarea de intrare normalizată, formată exclusiv din cifre. |
| npanxx | Prefixul stocat care corespunde numărului. Componenta care procesează cererea caută cu prioritate un prefix de șapte cifre pentru țară/zonă/centrală telefonică și, dacă nu îl găsește, poate utiliza un prefix de patru cifre pentru țară/zonă; nu presupuneți că acest câmp identifică întotdeauna o centrală telefonică în mod complet. |
| city, state, country | Metadate pentru prefixul de alocare găsit. Aceste câmpuri nu identifică locația fizică actuală a abonatului sau operatorul actual după portare. |
Erori
Verificați câmpul status.code din răspunsul JSON, fără a vă baza doar pe codul HTTP 200. Codul API 404 cu mesajul Not part of NANPA înseamnă că nu s-a găsit niciun prefix corespunzător în tabelul utilizat de serviciu; acesta nu reprezintă o decizie definitivă a unei autorități de numerotație la nivel mondial. Codul API 500 este utilizat când numărul de cifre este nevalid sau când numărul lipsește.
Cost și pașii următori
Implementarea de procesare a cererilor care a fost verificată efectuează o interogare locală a tabelului de alocări și nu include debitarea contului sau căutări externe. Această implementare nu aplică nicio taxă de căutare. Utilizați căutarea numerelor disponibile pentru a găsi numere disponibile pentru comandă. O căutare după nume, o căutare a informațiilor de rutare sau o comandă de număr reprezintă o operațiune distinctă, cu propriul tarif aplicabil contului.