Kontrolloni mbulimin e caktimit të numrave të Amerikës së Veriut

Kontrolloni mbulimin e tabelës së caktimit

Kontrolloni nëse një numër i Amerikës së Veriut përputhet me një prefiks në tabelën e caktimit të MultiTEL dhe merrni qytetin, shtetin dhe vendin përkatës. Ky është një kërkim në tabelën e prefikseve. Ai nuk vërteton se një pajtimtar është aktiv, se një numër është caktuar, se i përket llogarisë suaj apo se mund ta porositni.

Kërkesa

Përdorni llogarinë tuaj të aktivizuar të API-së dhe adresën IP të lejuar të burimit. Shembulli përdor kredenciale HTTP Basic nga variablat e mjedisit dhe një numër të trilluar. Nuk kërkohet trup i kërkesës.

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

Preferoni një numër të Amerikës së Veriut me njëmbëdhjetë shifra që fillon me 1. Përpunuesi heq karakteret që nuk janë shifra dhe shton 1 në fillim të një vlere hyrëse me dhjetë shifra. Vlerat me numër tjetër shifrash refuzohen. Ky normalizim nuk verifikon çdo rregull të numërtimit të Amerikës së Veriut, prandaj një përputhje e suksesshme në tabelë nuk përbën verifikim të plotë të numrit.

Përgjigjja

Vlerat e fushave shërbejnë vetëm si ilustrim; ky nuk është rezultat nga tabela e caktimit në përdorim.

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

Fushat e përputhjes në tabelën e caktimit
Fusha	Kuptimi
number	Vlera hyrëse e normalizuar që përmban vetëm shifra.
npanxx	Prefiksi i ruajtur që përputhet. Përpunuesi i jep përparësi një prefiksi vendi/zone/centrali me shtatë shifra dhe, si alternativë, mund të përdorë një prefiks vendi/zone me katër shifra; mos supozoni se kjo fushë identifikon gjithmonë një central të plotë.
city, state, country	Të dhëna përshkruese për prefiksin e caktimit që përputhet. Këto fusha nuk identifikojnë vendndodhjen fizike aktuale të një pajtimtari apo operatorin aktual pas bartjes së numrit.

Gabimet

Lexoni fushën status.code në JSON, në vend që të mbështeteni vetëm te HTTP 200. Kodi 404 i API-së me mesazhin Not part of NANPA do të thotë se asnjë prefiks nuk u përputh me tabelën e përdorur nga shërbimi; kjo nuk përbën një përcaktim përfundimtar nga një autoritet global i numërtimit. Kodi 500 i API-së përdoret kur numri i shifrave është i pavlefshëm ose kur numri mungon.

Kostoja dhe hapat e mëtejshëm

Përpunuesi i shqyrtuar kryen një kërkim lokal në tabelën e caktimit dhe nuk përmban as debitim të llogarisë, as kërkim të jashtëm. Ky përpunues nuk aplikon tarifë kërkimi. Përdorni kërkimin e numrave të disponueshëm për të gjetur numra në inventar që mund të porositen. Kërkimi i emrit, kërkimi i rrugëzimit ose porositja e një numri është një veprim tjetër, me çmimet e veta për llogarinë.