Programeri

GET/v3/nanpacheck/{number}

Provjerite pokrivenost sjevernoameričkih brojeva tablicom dodjele

Provjerite podudara li se broj sa zapisom u tablici dodjele, bez tumačenja rezultata kao provjere pretplatnika ili dostupnosti broja.

Na ovoj stranici
  1. Provjerite pokrivenost tablicom dodjele
  2. Zahtjev
  3. Odgovor
  4. Pogreške
  5. Trošak i sljedeći koraci

Provjerite pokrivenost tablicom dodjele

Provjerite podudara li se sjevernoamerički broj s prefiksom u MultiTEL-ovoj tablici dodjele i dohvatite pripadajući grad, saveznu državu i državu. Ovo je pretraživanje tablice prefiksa. Njime se ne utvrđuje je li pretplatnik aktivan, je li broj dodijeljen, pripada li vašem računu ni možete li ga naručiti.

Zahtjev

Upotrijebite svoj omogućeni API račun i dopuštenu izvorišnu IP adresu. Primjer upotrebljava vjerodajnice za HTTP Basic iz varijabli okruženja i izmišljeni broj. Tijelo zahtjeva nije potrebno.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/nanpacheck/12025550123

Preporučuje se jedanaesteroznamenkasti sjevernoamerički broj koji počinje znamenkom 1. Kod za obradu zahtjeva uklanja znakove koji nisu znamenke i dodaje 1 na početak deseteroznamenkastog unosa. Unosi s drukčijim brojem znamenki odbijaju se. Ova normalizacija ne provjerava sva pravila sjevernoameričkog plana numeriranja, pa uspješno podudaranje u tablici nije sveobuhvatna provjera valjanosti broja.

Odgovor

Vrijednosti polja služe samo kao primjer; ovo nije rezultat upita u stvarnu tablicu dodjele.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
Polja podudaranja u tablici dodjele
PoljeZnačenje
numberNormalizirani unos koji sadrži samo znamenke.
npanxxPohranjeni prefiks s kojim je pronađeno podudaranje. Kod za obradu zahtjeva daje prednost sedmeroznamenkastom prefiksu države, područja i telefonske centrale, a ako takvo podudaranje nije pronađeno, može upotrijebiti četveroznamenkasti prefiks države i područja; nemojte pretpostaviti da ovo polje uvijek identificira cijelu telefonsku centralu.
city, state, countryMetapodaci za prefiks dodjele s kojim je pronađeno podudaranje. Ova polja ne identificiraju trenutačnu fizičku lokaciju pretplatnika ni trenutačnog operatora nakon prijenosa broja.

Pogreške

Pročitajte polje JSON odgovora status.code umjesto da se oslanjate samo na HTTP 200. API kod 404 s porukom Not part of NANPA znači da nije pronađen nijedan podudarni prefiks u tablici kojom se usluga koristi; to nije konačna odluka nadležnog tijela za numeriranje na svjetskoj razini. API kod 500 upotrebljava se za nevaljan broj znamenki ili broj koji nedostaje.

Trošak i sljedeći koraci

Pregledani kod za obradu zahtjeva izvršava lokalni upit u tablicu dodjele i ne sadrži terećenje računa ni vanjsko pretraživanje. Ovaj kod za obradu zahtjeva ne naplaćuje naknadu za pretraživanje. Upotrijebite pretraživanje dostupnih brojeva kako biste pronašli brojeve iz ponude koji se mogu naručiti. Pretraživanje imena, provjera usmjeravanja ili naručivanje broja zasebna je radnja s vlastitim cijenama za vaš račun.