Controleer de dekking van Noord-Amerikaanse nummertoewijzingen

Controleer de dekking van de toewijzingstabel

Controleer of een Noord-Amerikaans nummer overeenkomt met een prefix in de toewijzingstabel van MultiTEL en haal de bijbehorende stad, staat en het land op. Dit is een zoekopdracht in een prefixtabel. Hiermee wordt niet vastgesteld dat een abonnee actief is, dat een nummer is toegewezen, dat het bij uw account hoort of dat u het kunt bestellen.

Verzoek

Gebruik uw ingeschakelde API-account en een toegestaan bron-IP-adres. Het voorbeeld gebruikt inloggegevens voor HTTP Basic uit omgevingsvariabelen en een fictief nummer. Een verzoekinhoud is niet vereist.

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

Gebruik bij voorkeur een Noord-Amerikaans nummer van elf cijfers dat begint met 1. De verwerkingscode verwijdert alle tekens die geen cijfers zijn en plaatst 1 voor invoer van tien cijfers. Andere aantallen cijfers worden afgewezen. Deze normalisatie controleert niet alle Noord-Amerikaanse nummeringsregels, dus een overeenkomst in de tabel vormt geen volledige validatie van het nummer.

Antwoord

De veldwaarden dienen uitsluitend ter illustratie; dit is geen resultaat uit de actuele toewijzingstabel.

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

Velden voor de gevonden toewijzing
Veld	Betekenis
number	Genormaliseerde invoer die uitsluitend uit cijfers bestaat.
npanxx	Het overeenkomende opgeslagen prefix. De verwerkingscode geeft de voorkeur aan een prefix van zeven cijfers voor land/netnummer/telefooncentrale en kan terugvallen op een prefix van vier cijfers voor land/netnummer; ga er niet van uit dat dit veld altijd een volledige telefooncentrale identificeert.
city, state, country	Metagegevens voor het overeenkomende toewijzingsprefix. Deze velden geven niet de huidige fysieke locatie van een abonnee of diens huidige provider na nummerportering aan.

Fouten

Lees status.code in het JSON-antwoord in plaats van alleen op HTTP 200 te vertrouwen. API-code 404 met de melding Not part of NANPA betekent dat geen prefix overeenkwam met de tabel die de dienst gebruikt; dit is geen definitief oordeel van een wereldwijde nummeringsautoriteit. API-code 500 wordt gebruikt bij een ongeldig aantal cijfers of een ontbrekend nummer.

Kosten en vervolgstappen

De beoordeelde verwerkingscode raadpleegt een lokale toewijzingstabel en bevat geen afschrijving van het accounttegoed of externe zoekopdracht. Deze verwerkingscode brengt geen opzoekkosten in rekening. Gebruik de zoekfunctie voor beschikbare nummers om nummers in de voorraad te vinden die u kunt bestellen. Het opzoeken van een naam, het opzoeken van routeringsgegevens of het bestellen van een nummer is een andere handeling waarvoor afzonderlijke accounttarieven gelden.