Patikrinkite paskirstymo lentelės aprėptį
Patikrinkite, ar Šiaurės Amerikos numeris atitinka prefiksą „MultiTEL“ paskirstymo lentelėje, ir gaukite su juo susietą miestą, valstiją ir šalį. Tai paieška prefiksų lentelėje. Ji nepatvirtina, kad abonentas yra aktyvus, kad numeris yra priskirtas, kad jis priklauso jūsų paskyrai ar kad galite jį užsisakyti.
Užklausa
Naudokite savo įgalintą API paskyrą ir leidžiamą šaltinio IP adresą. Pavyzdyje naudojami HTTP Basic prisijungimo duomenys iš aplinkos kintamųjų ir išgalvotas numeris. Užklausos turinys nereikalingas.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Rekomenduojama pateikti vienuolikos skaitmenų Šiaurės Amerikos numerį, prasidedantį 1. Užklausų apdorojimo kodas pašalina visus simbolius, kurie nėra skaitmenys, ir dešimties skaitmenų įvesties pradžioje prideda 1. Įvestys su kitokiu skaitmenų skaičiumi atmetamos. Šis normalizavimas netikrina visų Šiaurės Amerikos numeracijos taisyklių, todėl rastas atitikmuo lentelėje nėra išsami numerio patikra.
Atsakymas
Laukų reikšmės pateiktos tik kaip pavyzdys; tai nėra veikiančios paslaugos paskirstymo lentelės rezultatas.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Laukas | Reikšmė |
|---|---|
| number | Normalizuota įvestis, kurią sudaro tik skaitmenys. |
| npanxx | Atitinkantis išsaugotas prefiksas. Užklausų apdorojimo kodas pirmenybę teikia septynių skaitmenų šalies, vietovės ir telefono stoties prefiksui, o jo neradęs gali naudoti keturių skaitmenų šalies ir vietovės prefiksą; nemanykite, kad šis laukas visada nurodo visą telefono stoties kodą. |
| city, state, country | Rasto paskirstymo prefikso metaduomenys. Šie laukai nenurodo dabartinės abonento fizinės buvimo vietos ar dabartinio ryšio operatoriaus po numerio perkėlimo. |
Klaidos
Skaitykite JSON lauką status.code, užuot pasikliovę vien HTTP 200. API kodas 404 su pranešimu Not part of NANPA reiškia, kad paslaugos naudojamoje lentelėje nerasta atitinkančio prefikso; tai nėra galutinė pasauliniu mastu taikoma numeraciją administruojančios institucijos išvada. API kodas 500 naudojamas, kai skaitmenų skaičius netinkamas arba numeris nepateiktas.
Kaina ir tolesni veiksmai
Peržiūrėtas užklausų apdorojimo kodas pateikia užklausą vietinei paskirstymo lentelei ir neatlieka nei lėšų nurašymo iš paskyros, nei išorinės paieškos. Šis kodas netaiko paieškos mokesčio. Naudokite prieinamų numerių paiešką užsakomiems numeriams rasti. Vardo paieška, maršruto paieška ar numerio užsakymas yra atskira operacija, kuriai taikomi atskiri paskyros įkainiai.