Kërkoni emrin e një telefonuesi

Kërkoni emrin e një telefonuesi

Merrni një rezultat të disponueshëm për emrin e telefonuesit për një numër telefoni. Ky kërkim kryhet në mjedisin e prodhimit dhe mund të sjellë tarifim në llogarinë tuaj, edhe kur rezultati vjen nga memoria e përkohshme e shërbimit. Ai nuk ndryshon emrin që shfaqet gjatë thirrjeve dalëse nga një numër që zotëroni.

Një emër i kthyer nuk përbën identitet të verifikuar, provë pronësie apo leje për të telefonuar. Emrat mund të mungojnë, të jenë të vjetruar ose të shkurtuar, të jenë emërtime gjeografike ose të zëvendësohen me numrin e telefonit.

Kërkesa

Përdorni llogarinë tuaj të aktivizuar API nga adresa IP e burimit e lejuar për të. Ruajini kredencialet në një depo sekretesh në anën e serverit. Shembulli përdor ndryshore mjedisi dhe një numër të trilluar të Amerikës së Veriut; mos i vendosni kredencialet në URL ose në kod publik që ekzekutohet në shfletues.

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

Jepeni numrin e plotë me shifra, përfshirë kodin e shtetit, për shembull njëmbëdhjetë shifra që fillojnë me 1 për Amerikën e Veriut. Mos u mbështetni te përpunuesi i kërkesës për normalizimin e shenjave të pikësimit ose të shenjës plus. Nuk nevojitet trup kërkese apo përzgjedhës rajoni. Konfirmoni me MultiTEL mbulimin e mbështetur për përdorimin që synoni.

Përgjigjja

Vlerat janë vetëm ilustruese; kostoja nuk përbën ofertë çmimi.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Tarifimi dhe rakordimi

Rezultatet që përmbajnë emër tarifohen sipas çmimit CNAM të konfiguruar për llogarinë. Një kërkim i përsëritur ose i shërbyer nga memoria e përkohshme mund të sjellë një tarifim tjetër; nuk vihet në dispozicion asnjë çelës idempotence. Kontrolloni tarifën aktuale të llogarisë përpara se të aktivizoni kërkimet automatike.

Ekziston një kufizim i njohur i përgjigjes kur emri në memorien e përkohshme është bosh: përpunuesi mund të kthejë kodin API 200 me një emër bosh, një kosto të ndryshme nga zero dhe një gjendje të llogaritur të zvogëluar, edhe pse ajo degë përpunimi nuk e debiton llogarinë. Mos e konsideroni vetëm atë përgjigje si provë tarifimi. Rakordojeni me të dhënat e faturimit të llogarisë dhe me një kërkim të ri të gjendjes së llogarisë, dhe kontaktoni mbështetjen për rezultate të paqarta.

Kontrolli i parapagimit aktualisht kërkon një gjendje prej të paktën 0.004 përpara kërkimit, pavarësisht çmimit të konfiguruar për kërkim. Refuzohet gjithashtu një llogari me blerjet të çaktivizuara. Këto kontrolle nuk e bëjnë këtë pikë fundore një API për oferta çmimi ose kufizimin e shpenzimeve.

Gabimet dhe riprovimet

Kontrolloni si statusin HTTP, ashtu edhe fushat status.code/status.msg në JSON. Kodi API 403 mund të nënkuptojë kredit të pamjaftueshëm të parapaguar, blerje të ndaluara, një problem me autorizimin e llogarisë ose që nuk u gjet asnjë emër telefonuesi. Rrjedha pa emër mund ta kthejë kodin si varg teksti. Shqyrtoni mesazhin në vend që ta interpretoni çdo kod 403 si kredenciale të pasakta. Konfliktet e konfigurimit mund të kthejnë kodin API 500.

Afati i pritjes mund të skadojë pas një kërkimi të tarifueshëm. Përdorni një numër të kufizuar riprovimesh me intervale pritjeje në rritje vetëm kur kjo është e përshtatshme për aplikacionin tuaj dhe rakordoni fillimisht përpjekjet me rezultat të pasigurt. Mos riprovoni vazhdimisht një numër të refuzuar ose një kërkesë të dështuar për shkak të lejeve apo gjendjes së llogarisë. Një memorie e përkohshme përgjigjesh në aplikacionin tuaj mund të zvogëlojë kërkesat e përsëritura, në përputhje me marrëveshjen tuaj dhe kërkesat për saktësi.

Veprime të tjera me numrat

Ky veprim leximi është i veçantë nga përditësimi i emrit të thirrjeve dalëse/LIDB, nga përfshirja në një numërator telefonik apo nga regjistrimi i telefonuesit. Ato veprime kanë fushat e tyre të detyrueshme, kërkesat për autorizim dhe tarifat përkatëse. Përdorni mbulimin e alokimeve për një kontroll në tabelën e prefikseve ose kërkimin e numrave për inventarin e numrave që mund të porositen. Asnjëri prej këtyre veprimeve nuk vërteton se një telefonues është personi që pretendon të jetë.