Ontwikkelaars

GET/v3/nanpacheck/{number}

Kontroleer Noord-Amerikaanse toekenningsdekking

Vergelyk 'n nommer met die toekenningstabel sonder om dit as validering van 'n intekenaar of beskikbaarheid te beskou.

Op hierdie bladsy
  1. Kontroleer die dekking van die toekenningstabel
  2. Versoek
  3. Antwoord
  4. Foute
  5. Koste en volgende stappe

Kontroleer die dekking van die toekenningstabel

Kontroleer of 'n Noord-Amerikaanse nommer met 'n voorvoegsel in MultiTEL se toekenningstabel ooreenstem, en haal die gepaardgaande stad, deelstaat en land op. Dit is 'n naslaan in 'n voorvoegseltabel. Dit bevestig nie dat 'n intekenaar aktief is, dat 'n nommer toegeken is, dat dit aan jou rekening behoort of dat jy dit kan bestel nie.

Versoek

Gebruik jou geaktiveerde API-rekening en toegelate bron-IP-adres. Die voorbeeld gebruik HTTP Basic-aanmeldbesonderhede uit omgewingsveranderlikes en 'n fiktiewe nommer. Geen versoekliggaam word vereis nie.

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

Gebruik verkieslik 'n Noord-Amerikaanse nommer van elf syfers wat met 1 begin. Die hanteerder verwyder alle karakters wat nie syfers is nie en voeg 1 vooraan 'n invoer van tien syfers by. Ander syfertellings word verwerp. Hierdie normalisering valideer nie elke Noord-Amerikaanse nommeringsreël nie; 'n suksesvolle passing in die tabel is dus nie 'n volledige validering van die nommer nie.

Antwoord

Slegs illustratiewe veldwaardes; dit is nie 'n resultaat uit die lewendige toekenningstabel nie.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
Velde vir die toekenningspassing
VeldBetekenis
numberGenormaliseerde invoer wat slegs uit syfers bestaan.
npanxxDie gestoorde voorvoegsel wat ooreenstem. Die hanteerder verkies 'n land-/gebied-/sentralevoorvoegsel van sewe syfers en kan op 'n land-/gebiedsvoorvoegsel van vier syfers terugval; moenie aanvaar dat hierdie veld altyd 'n volledige telefoonsentrale identifiseer nie.
city, state, countryMetadata vir die toekenningsvoorvoegsel wat ooreenstem. Hierdie velde identifiseer nie 'n intekenaar se huidige fisiese ligging of huidige diensverskaffer ná nommeroordrag nie.

Foute

Lees die JSON-veld status.code eerder as om slegs op HTTP 200 staat te maak. API-kode 404 met die boodskap Not part of NANPA beteken dat geen voorvoegsel met die tabel wat die diens gebruik, ooreengestem het nie; dit is nie 'n definitiewe wêreldwye bepaling deur 'n nommeringsowerheid nie. API-kode 500 word vir 'n ongeldige syfertelling of 'n ontbrekende nommer gebruik.

Koste en volgende stappe

Die hanteerder wat nagegaan is, doen 'n plaaslike navraag in die toekenningstabel en bevat geen rekeningdebitering of eksterne naslaan nie. Hierdie hanteerder hef geen naslaanfooi nie. Gebruik die soektog na beskikbare nommers om beskikbare nommers te vind wat bestel kan word. 'n Naamnaslaan, roeteringsnaslaan of nommerbestelling is 'n ander bewerking met sy eie rekeningtariewe.