Sjekk dekning i den nordamerikanske tildelingstabellen

Sjekk dekning i tildelingstabellen

Sjekk om et nordamerikansk nummer samsvarer med et prefiks i MultiTELs tildelingstabell, og hent tilhørende by, delstat og land. Dette er et oppslag i en prefikstabell. Det fastslår ikke at en abonnent er aktiv, at et nummer er tildelt, at det tilhører kontoen din, eller at du kan bestille det.

Forespørsel

Bruk den aktiverte API-kontoen din og en tillatt kilde-IP-adresse. Eksemplet bruker påloggingsopplysninger for HTTP Basic fra miljøvariabler og et fiktivt nummer. Det kreves ingen forespørselskropp.

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

Bruk helst et nordamerikansk nummer med elleve sifre som begynner med 1. Implementasjonen fjerner alle tegn som ikke er sifre, og legger til 1 foran inndata med ti sifre. Andre antall sifre avvises. Denne normaliseringen kontrollerer ikke alle nordamerikanske nummereringsregler, så et treff i tabellen er ikke en fullstendig validering av nummeret.

Svar

Feltverdiene er bare eksempler; dette er ikke et resultat fra tildelingstabellen i drift.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

Felter ved treff i tildelingstabellen
Felt	Betydning
number	Normaliserte inndata som bare inneholder sifre.
npanxx	Det lagrede prefikset som samsvarer med nummeret. Implementasjonen foretrekker et prefiks med sju sifre for land, område og telefonsentral, og kan falle tilbake på et prefiks med fire sifre for land og område; ikke anta at dette feltet alltid identifiserer en fullstendig telefonsentralkode.
city, state, country	Metadata for tildelingsprefikset som ga treff. Disse feltene identifiserer ikke abonnentens nåværende fysiske plassering eller nåværende operatør etter portering.

Feil

Les status.code i JSON-svaret i stedet for å stole utelukkende på HTTP 200. API-kode 404 med meldingen Not part of NANPA betyr at ingen prefikser samsvarte med nummeret i tabellen tjenesten bruker; dette er ikke en endelig avgjørelse fra en global nummereringsmyndighet. API-kode 500 brukes når antallet sifre er ugyldig eller nummeret mangler.

Kostnader og neste steg

Den gjennomgåtte implementasjonen gjør et lokalt oppslag i tildelingstabellen og inneholder ingen kontobelastning eller eksterne oppslag. Denne implementasjonen belaster ikke noe oppslagsgebyr. Bruk søk etter tilgjengelige numre for å finne numre som kan bestilles. Navneoppslag, rutingsoppslag og nummerbestilling er andre operasjoner med egne priser for kontoen.