Ověření pokrytí v tabulce přidělení
Ověřte, zda severoamerické číslo odpovídá některé předvolbě v tabulce přidělení společnosti MultiTEL, a získejte související město, stát a zemi. Jde o vyhledávání v tabulce předvoleb. Výsledek nepotvrzuje, že je účastník aktivní, že je číslo přidělené, že patří k vašemu účtu ani že si ho můžete objednat.
Požadavek
Použijte svůj aktivovaný účet API a povolenou zdrojovou IP adresu. Příklad používá přihlašovací údaje pro HTTP Basic z proměnných prostředí a smyšlené číslo. Tělo požadavku není vyžadováno.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Přednostně používejte jedenáctimístné severoamerické číslo začínající číslicí 1. Obslužná funkce odstraní znaky, které nejsou číslicemi, a před desetimístný vstup přidá číslici 1. Jiné počty číslic jsou odmítnuty. Tato normalizace neověřuje všechna pravidla severoamerického číslovacího plánu, takže nalezení shody v tabulce nepředstavuje úplné ověření platnosti čísla.
Odpověď
Hodnoty polí jsou pouze ilustrační; nejde o výsledek dotazu do aktuální tabulky přidělení.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Pole | Význam |
|---|---|
| number | Normalizovaný vstup obsahující pouze číslice. |
| npanxx | Uložená předvolba odpovídající vstupu. Obslužná funkce upřednostňuje sedmimístnou předvolbu země/oblasti/ústředny a jako náhradní možnost může použít čtyřmístnou předvolbu země/oblasti; nepředpokládejte, že toto pole vždy obsahuje úplnou předvolbu ústředny. |
| city, state, country | Metadata pro nalezenou předvolbu v tabulce přidělení. Tato pole neurčují aktuální fyzickou polohu účastníka ani aktuálního operátora po přenesení čísla. |
Chyby
Zkontrolujte v odpovědi JSON pole status.code a nespoléhejte se pouze na stav HTTP 200. Kód API 404 se zprávou Not part of NANPA znamená, že v tabulce používané službou nebyla nalezena žádná odpovídající předvolba; nejde o definitivní rozhodnutí celosvětové autority pro správu číslování. Kód API 500 se používá při neplatném počtu číslic nebo chybějícím čísle.
Cena a další kroky
Přezkoumaná obslužná funkce provádí dotaz do místní tabulky přidělení a neobsahuje žádné stržení prostředků z účtu ani externí vyhledávání. Tato obslužná funkce neúčtuje za vyhledání žádný poplatek. Použijte vyhledávání dostupných čísel k nalezení čísel z nabídky, která lze objednat. Vyhledání jména, vyhledání směrování nebo objednání čísla představuje jinou operaci s vlastním naceněním pro daný účet.