Kërkoni informacion për rutimin

Kërkoni informacion rutimi për një numër telefoni të Amerikës së Veriut. Përdoreni për të interpretuar të dhënat e disponueshme për rutimin dhe operatorin, jo si provë të identitetit të pajtimtarit, të pronësisë së numrit, të mundësisë për ta kontaktuar apo të disponueshmërisë së numrit për blerje. Një kërkim mund të sjellë një tarifë në llogarinë tuaj.

Kërkesa

Përdorni llogarinë tuaj të aktivizuar API dhe adresën IP burimore të lejuar për të. Jepni numrin e plotë vetëm me shifra, duke përfshirë kodin e shtetit 1. Shembulli përdor variabla të mjedisit dhe një numër të trilluar. Përpunuesi nuk i normalizon shenjat e pikësimit; verifikoni të dhënat hyrëse para se t'i dërgoni.

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

Përgjigjja

Paraqiten vetëm disa fusha të përzgjedhura për ilustrim; disponueshmëria varet nga burimi dhe lloji i numrit.

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

Kërkimi standard i kthen emrat e fushave të kthyera në shkronja të vogla. Në varësi të burimit, mund të jenë të pranishme fusha për operatorin, qendrën e tarifimit, vendndodhjen dhe juridiksionin. Përgjigjja nuk është një regjistrim i plotë i pajtimtarit me strukturë fikse. Treguesi local mund të jetë vlera numerike 1 ose vargu i karaktereve 0. Përpunuesi e llogarit ported duke krahasuar numrin e rutimit të kthyer me numrin e telefonit të dhënë; mos e interpretoni si një historik të plotë dhe të verifikuar të bartjes së numrit.

Çmimi dhe riprovimet

Përpunuesi i shqyrtuar debiton llogarinë me $0.00025 kur arrin në rrugën e përfundimit dhe regjistron kërkimin. Kostoja e kthyer zakonisht është një varg karakteresh që përfshin shenjën e dollarit, dhe jo thjesht një vlerë numerike. Nuk ofrohet asnjë çelës idempotence. Përsëritja e një kërkese mund të sjellë një tarifë tjetër.

Për llogaritë me parapagim, kodi kontrollon nëse gjendja është të paktën 0.00025. Mesazhi për gjendje të pamjaftueshme aktualisht përmend $5, që nuk përputhet me atë prag. Interpretojeni dështimin si refuzim për shkak të gjendjes së llogarisë dhe verifikoni fondet e llogarisë para se të riprovoni.

Dështimet dhe suksesi i paplotë

Lexoni si statusin HTTP, ashtu edhe status.code/status.msg në JSON. Një rezultat bosh i kërkimit standard kthen kodin API 404. Kodi API 403 mund të tregojë gjendje të pamjaftueshme në llogarinë me parapagim.

Një rrugë aktuale e trajtimit të gabimeve për numrat me thirrje pa pagesë mund ta debitojë gjithsesi shumën e kërkimit dhe të raportojë kodin API 200 pa fusha të dobishme rutimi; informacioni për koston mund të jetë i paplotë. Prandaj, vetëm kodi 200 nuk vërteton se kërkimi është i përdorshëm. Verifikoni fushat që i duhen aplikacionit tuaj, krahasoni tarifat e paqarta me regjistrimet e faturimit të llogarisë dhe kontaktoni mbështetjen për rezultatet e paplota.

Në zbatimin e shqyrtuar, trajtimi i numrave me thirrje pa pagesë ndryshon sipas gjatësisë së të dhënave hyrëse. Përdorni mundësisht të gjitha shifrat e numrit në format ndërkombëtar dhe konfirmoni me mbështetjen mbulimin e nevojshëm për numrat me thirrje pa pagesë. Mos e përsëritni automatikisht një kërkim që ka dhënë rezultat me format të gabuar ose të paplotë dhe mos u mbështetni në një kërkim rutimi për të vendosur nëse është e sigurt apo e autorizuar të telefononi një numër.