Kontrollera täckningen för nordamerikanska nummertilldelningar

Kontrollera tilldelningstabellens täckning

Kontrollera om ett nordamerikanskt nummer matchar ett prefix i MultiTELs tilldelningstabell och hämta tillhörande stad, delstat och land. Detta är en uppslagning i en prefixtabell. Den fastställer inte att en abonnent är aktiv, att ett nummer är tilldelat, att det tillhör ditt konto eller att du kan beställa det.

Förfrågan

Använd ditt aktiverade API-konto och en tillåten käll-IP-adress. Exemplet använder autentiseringsuppgifter för HTTP Basic från miljövariabler och ett fiktivt nummer. Ingen meddelandekropp krävs.

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

Använd helst ett elvasiffrigt nordamerikanskt nummer som börjar med 1. Hanteraren tar bort alla tecken som inte är siffror och lägger till 1 i början av en tiosiffrig inmatning. Andra antal siffror avvisas. Denna normalisering kontrollerar inte alla nordamerikanska numreringsregler, så en lyckad tabellmatchning innebär inte en fullständig validering av numret.

Svar

Fältvärdena är endast exempel; detta är inte ett resultat från tilldelningstabellen i drift.

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

Fält för tilldelningsmatchningen
Fält	Betydelse
number	Normaliserad inmatning som endast innehåller siffror.
npanxx	Det lagrade prefix som matchar. Hanteraren väljer i första hand ett sjusiffrigt prefix för land, riktnummer och telefonväxel och kan i andra hand använda ett fyrsiffrigt prefix för land och riktnummer; förutsätt inte att detta fält alltid identifierar en fullständig telefonväxel.
city, state, country	Metadata för det matchade tilldelningsprefixet. Dessa fält anger inte en abonnents aktuella fysiska plats eller nuvarande operatör efter nummerportering.

Fel

Läs JSON-fältet status.code i stället för att enbart förlita dig på HTTP 200. API-koden 404 med meddelandet Not part of NANPA innebär att inget prefix matchade tabellen som tjänsten använder; det är inte ett slutgiltigt besked från en global numreringsmyndighet. API-koden 500 används när antalet siffror är ogiltigt eller numret saknas.

Kostnad och nästa steg

Den granskade hanteraren gör en lokal sökning i tilldelningstabellen och innehåller ingen kontodebitering eller extern uppslagning. Denna hanterare tar inte ut någon avgift för uppslagningen. Använd sökningen efter tillgängliga nummer för att hitta nummer i beståndet som går att beställa. En namnuppslagning, en uppslagning av routningsinformation eller en nummerbeställning är en separat åtgärd med egen prissättning för kontot.