Integrimi CNAM
Referenca e API-t REST të CNAM
Kërkoni një emër telefonuesi përmes HTTPS dhe trajtoni rezultatin, tarifën dhe gabimet.
Zgjidhni sjelljen e kërkimit
| Niveli | Çmimi publik për kërkim | Çfarë bën |
|---|---|---|
| Starter | 0,0026 US$ | Përdor informacion të vet dhe të ruajtur në cache për emrat e telefonuesve. |
| Standard | 0,0037 US$ | Bën një kërkim në kohë reale në rrjet për çdo kërkesë. |
| Mixed | 0,004 US$ | Provon fillimisht një kërkim në kohë reale, pastaj kalon te të dhënat e Starter kur nuk gjendet emër. |
Shërbimi i zgjedhur përcakton sjelljen e kërkimit; Mixed nuk është kërkim që përdor fillimisht cache-in. Shqyrtoni tarifën e caktuar për llogarinë tuaj përpara përdorimit real. Emri i telefonuesit nuk është provë identiteti apo pronësie.
Dërgoni një kërkim të autentikuar
Pika fundore: GET https://api.multitel.net/v3/cnam/NUMBER. Përdorni numra telefoni në format ndërkombëtar me kodin e shtetit, vetëm me shifra, pa shenja pikësimi dhe pa plus në fillim. Ekzekutojeni nga serveri i aplikacionit tuaj duke përdorur kredenciale API të miratuara.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Jepini dy variablat e mjedisit përmes konfigurimit të sekreteve në anën e serverit. Një kredencial bearer i ofruar është alternativë vetëm kur ai akses është i aktivizuar dhe kufizimet e IP-së burimore plotësohen. Mos e vendosni kurrë një sekret API në një paketë publike kodi për shfletuesin.
Lexoni përgjigjen JSON
Kjo përgjigje është ilustruese. Emri i kthyer dhe tarifa varen nga kërkimi dhe shërbimi i zgjedhur.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Kodi i rezultatit të aplikacionit; normalizoni vlerat tekstuale/numerike përpara se t'i krahasoni me 200.
status.msg- Mesazhi shoqërues i rezultatit ose i refuzimit.
response.number- Numri i kërkuar.
response.name- Emri i disponueshëm i telefonuesit.
response.cost- Tarifa e raportuar për këtë kërkim; trajtojeni si shumë dhjetore.
response.balance- Bilanci i raportuar i llogarisë, kur është i disponueshëm.
Rezultate pa emër dhe gabime
Një kërkesë e suksesshme nuk garanton një emër telefonuesi të dobishëm. Trajtoni emrin bosh, numrin e kthyer në vend të emrit dhe kërkimin e refuzuar. Kodi i aplikacionit 403 mund të tregojë kredit të pamjaftueshëm, blerje të ndaluar ose numër pa rezultat; shqyrtoni mesazhin.
Kontrolloni si statusin HTTP, ashtu edhe status të JSON-it përpara se të përdorni response.name. Objekti i përgjigjes mund të mungojë në rast gabimi. Mungesa e emrit nuk duhet ta pengojë rrugëzimin normal të thirrjes.
Faturimi, ritentimet dhe dallimi nga përditësimi i identifikuesit të telefonuesit
Një kërkim i ri mund të sjellë tarifë kërkimi. Këto ndërfaqe kërkimi nuk dokumentojnë çelës idempotence, kështu që një ritentim i ri mund të jetë kërkim i dytë i faturueshëm. Përdorni backoff të kufizuar për dështime transporti/shërbimi, zgjidhni fillimisht gabimet e llogarisë dhe pajtoni tarifat e raportuara të kërkimeve. Ruajeni në cache vetëm për një periudhë të përshtatshme për aplikacionin tuaj; të dhënat e emrit të telefonuesit mund të ndryshojnë.
Një kërkim CNAM lexon një emër. Ai nuk e ndryshon emrin që shfaqet te thirrjet tuaja dalëse. Përditësimi i emrit të telefonuesit në LIDB është një operacion më vete, me fushat, autorizimin, çmimin dhe përpunimin e vet.