A számkiosztási tábla lefedettségének ellenőrzése
Ellenőrizze, hogy egy észak-amerikai szám illeszkedik-e a MultiTEL számkiosztási táblájában szereplő valamely előtaghoz, és kérje le a hozzá tartozó várost, államot és országot. Ez egy előtagtáblában végzett keresés. Nem igazolja, hogy az előfizető aktív, hogy a számot előfizetőhöz rendelték, hogy az Ön fiókjához tartozik, vagy hogy megrendelheti.
Kérés
Használja az engedélyezett API-fiókját és az engedélyezett forrás-IP-címet. A példa környezeti változókból származó HTTP Basic hitelesítési adatokat és egy kitalált számot használ. Kéréstörzs nem szükséges.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Lehetőleg tizenegy számjegyű, 1 számjeggyel kezdődő észak-amerikai számot adjon meg. A kezelő eltávolítja a nem számjegy karaktereket, és tíz számjegyű bemenet esetén 1 számjegyet illeszt az elejére. Az ettől eltérő számjegyszámú bemeneteket elutasítja. Ez a normalizálás nem ellenőriz minden észak-amerikai számozási szabályt, így a sikeres táblabeli egyezés nem jelent teljes körű számellenőrzést.
Válasz
A mezőértékek kizárólag szemléltető jellegűek; ez nem az éles számkiosztási táblából származó eredmény.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Mező | Jelentés |
|---|---|
| number | Normalizált, kizárólag számjegyeket tartalmazó bemenet. |
| npanxx | Az illeszkedő tárolt előtag. A kezelő elsődlegesen a hét számjegyű ország-/körzet-/telefonközpont-előtagot keresi, és ennek hiányában a négy számjegyű ország-/körzet-előtagra térhet vissza; ne feltételezze, hogy ez a mező mindig egy teljes telefonközpontot azonosít. |
| city, state, country | Az illeszkedő számkiosztási előtaghoz tartozó metaadatok. Ezek a mezők nem azonosítják az előfizető aktuális fizikai helyét, sem a számhordozás utáni aktuális szolgáltatóját. |
Hibák
A JSON válasz status.code mezőjét olvassa ki, ne hagyatkozzon kizárólag a HTTP 200 állapotra. A 404 API-kód a Not part of NANPA üzenettel azt jelenti, hogy egyetlen előtag sem illeszkedett a szolgáltatás által használt táblában; ez nem a számozási hatóságok globális szinten véglegesnek tekinthető állásfoglalása. Az 500 API-kód érvénytelen számjegyszámot vagy hiányzó számot jelez.
Költségek és további lépések
A felülvizsgált kezelő helyi számkiosztási táblát kérdez le, és nem tartalmaz számlaegyenleg-terhelést vagy külső lekérdezést. Ez a kezelő nem számít fel lekérdezési díjat. Használja az elérhető számok keresése funkciót a megrendelhető számkészlet kereséséhez. A névlekérdezés, az útválasztási adatok lekérdezése és a szám megrendelése külön művelet, amelyre a fiókhoz tartozó külön díjszabás vonatkozik.