Kontrollér dækningen i allokeringstabellen
Kontrollér, om et nordamerikansk nummer matcher et præfiks i MultiTELs allokeringstabel, og hent den tilknyttede by, delstat og det tilknyttede land. Dette er et opslag i en præfikstabel. Det fastslår ikke, at en abonnent er aktiv, at et nummer er tildelt, at det tilhører din konto, eller at du kan bestille det.
Forespørgsel
Brug din aktiverede API-konto og en tilladt kilde-IP-adresse. Eksemplet bruger legitimationsoplysninger til HTTP Basic fra miljøvariabler og et fiktivt nummer. Der kræves ingen forespørgselskrop.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Brug helst et nordamerikansk nummer med elleve cifre, der begynder med 1. Forespørgselsbehandleren fjerner alle tegn, der ikke er cifre, og sætter 1 foran et input med ti cifre. Andre antal cifre afvises. Denne normalisering kontrollerer ikke alle nordamerikanske nummereringsregler, så et match i tabellen er ikke en udtømmende validering af nummeret.
Svar
Feltværdierne er kun eksempler; dette er ikke et resultat fra et aktuelt opslag i allokeringstabellen.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Felt | Betydning |
|---|---|
| number | Normaliseret input, der kun indeholder cifre. |
| npanxx | Det gemte præfiks, der matcher. Forespørgselsbehandleren foretrækker et syvcifret præfiks for land/område/central og kan som alternativ bruge et firecifret præfiks for land/område; antag ikke, at dette felt altid identificerer en fuld central. |
| city, state, country | Metadata for det allokeringspræfiks, der matcher. Disse felter identificerer ikke en abonnents aktuelle fysiske placering eller nuværende teleoperatør efter nummerportering. |
Fejl
Læs status.code i JSON-svaret i stedet for udelukkende at stole på HTTP 200. API-koden 404 med meddelelsen Not part of NANPA betyder, at intet præfiks matchede i den tabel, tjenesten bruger; det er ikke en endelig afgørelse fra en global nummereringsmyndighed. API-koden 500 bruges ved et ugyldigt antal cifre eller et manglende nummer.
Pris og næste skridt
Den gennemgåede forespørgselsbehandler foretager en lokal forespørgsel i allokeringstabellen og indeholder hverken debitering af kontoen eller eksterne opslag. Denne forespørgselsbehandler opkræver intet gebyr for opslaget. Brug søgning efter tilgængelige numre til at finde numre i beholdningen, som kan bestilles. Et navneopslag, et routingopslag eller en nummerbestilling er en anden handling med særskilt prissætning for kontoen.