Útválasztási adatok lekérdezése

Kérdezze le egy észak-amerikai telefonszám útválasztási adatait. Az eredményt az elérhető útválasztási és szolgáltatói adatok értelmezésére használja, ne az előfizető személyazonosságának, a szám tulajdonjogának, elérhetőségének vagy megvásárolhatóságának bizonyítékaként. A lekérdezés díjjal terhelheti a fiókját.

Kérés

Használja az engedélyezett API-fiókját és az ahhoz engedélyezett forrás IP-címet. A teljes számot számjegyekkel adja meg, az 1 országhívószámmal együtt. A példa környezeti változókat és egy kitalált számot használ. A kéréskezelő nem normalizálja az írásjeleket; beküldés előtt ellenőrizze a bemenetet.

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

Válasz

Csak néhány kiválasztott mező szerepel szemléltetésként; az elérhetőségük a forrástól és a szám típusától függ.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

A normál lekérdezés kisbetűssé alakítja a visszaadott mezőneveket. A forrástól függően szolgáltatói, díjszabási körzetre, helyre és joghatóságra vonatkozó mezők is szerepelhetnek. A válasz nem egy rögzített szerkezetű, teljes előfizetői adatlap. A local jelző értéke lehet az 1 szám vagy a 0 karakterlánc. A kéréskezelő a visszaadott útválasztási számot a megadott telefonszámmal összehasonlítva számítja ki a ported értékét; ne értelmezze ezt ellenőrzött, teljes számhordozási előzményként.

Díjak és újrapróbálkozások

A felülvizsgált kéréskezelő $0.00025 összeggel terheli meg a fiókot, amikor eléri a befejezési ágát és rögzíti a lekérdezést. A visszaadott költség általában a dollárjelet is tartalmazó karakterlánc, nem pusztán egy számérték. Idempotenciakulcs nem áll rendelkezésre. Egy kérés megismétlése újabb díjat eredményezhet.

Előre fizetett fiókoknál a kód legalább 0.00025 összegű egyenleget ellenőriz. Az elégtelen egyenlegről szóló üzenete jelenleg $5 összeget említ, ami nem egyezik ezzel a küszöbértékkel. A hibát az egyenleg miatti elutasításként értelmezze, és újrapróbálkozás előtt ellenőrizze a fiók fedezetét.

Hibák és hiányos sikeres eredmények

Ellenőrizze mind a HTTP állapotát, mind a JSON status.code/status.msg mezőit. Üres normál lekérdezési eredmény esetén a visszaadott API-kód 404. Az API 403 kódja elégtelen előre fizetett egyenleget jelezhet.

A díjmentesen hívható számok egyik jelenlegi hibakezelési ága hasznos útválasztási mezők nélkül is levonhatja a lekérdezés díját, és 200 értékű API-kódot adhat vissza; a költségadata hiányos lehet. A 200 kód ezért önmagában nem igazolja, hogy a lekérdezés használható eredményt adott. Ellenőrizze az alkalmazásának szükséges mezőket, egyeztesse a bizonytalan terheléseket a fiók számlázási nyilvántartásával, és hiányos eredmények esetén forduljon az ügyfélszolgálathoz.

A felülvizsgált megvalósításban a díjmentesen hívható számok kezelése a bemenet hosszától függően eltér. Lehetőleg a teljes nemzetközi számot adja meg számjegyekkel, és az ügyfélszolgálattal erősíttesse meg a díjmentesen hívható számok szükséges lefedettségét. Hibás formátumú vagy hiányos eredmény esetén ne próbálkozzon újra automatikusan, és ne útválasztási lekérdezés alapján döntse el, hogy egy szám hívása biztonságos vagy engedélyezett-e.