CNAM integracija

Referenca CNAM REST API-ja

Zatražite ime pozivatelja putem HTTPS-a i obradite rezultat, naknadu i pogreške.

Odaberite ponašanje upita

Razina	Javna cijena po upitu	Što radi
Starter	0,0026 USD	Koristi vlastite informacije o imenima pozivatelja i informacije iz predmemorije.
Standard	0,0037 USD	Za svaki upit obavlja mrežni upit u stvarnom vremenu.
Mixed	0,004 USD	Najprije pokušava upit u stvarnom vremenu, a zatim se vraća na podatke razine Starter kada ime nije pronađeno.

Odabrana usluga određuje ponašanje upita; Mixed nije upit koji prvo koristi predmemoriju. Prije produkcijske uporabe provjerite tarifu dodijeljenu vašem računu. Ime pozivatelja nije dokaz identiteta ni vlasništva.

Pošaljite autentificirani upit

Krajnja točka: GET https://api.multitel.net/v3/cnam/NUMBER. Navedite telefonski broj u međunarodnom formatu s pozivnim brojem zemlje, samo znamenkama, bez interpunkcije i početnog znaka plus. Izvršite ovo s poslužitelja svoje aplikacije koristeći odobrene API vjerodajnice.

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

Dvije varijable okruženja postavite putem konfiguracije tajni na strani poslužitelja. Dodijeljena bearer vjerodajnica alternativa je samo ako je taj pristup omogućen i ako su zadovoljena njezina ograničenja izvorne IP adrese. Nikada ne stavljajte API tajnu u javni preglednički bundle.

Vodič za API autentifikaciju i prvi zahtjev

Pročitajte JSON odgovor

Ovaj odgovor je ilustrativan. Vraćeno ime i naknada ovise o upitu i odabranoj usluzi.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: Aplikacijski kod rezultata; normalizirajte tekstualne i numeričke vrijednosti prije usporedbe s 200.
status.msg: Popratna poruka o ishodu ili odbijanju.
response.number: Upitani broj.
response.name: Dostupno ime pozivatelja.
response.cost: Naknada prijavljena za ovaj upit; tretirajte je kao decimalni iznos.
response.balance: Prijavljeno stanje računa, kada je prisutno.

Rezultati bez imena i pogreške

Uspješan zahtjev ne jamči korisno ime pozivatelja. Obradite prazno ime, broj vraćen umjesto imena i odbijen upit. Aplikacijski kod 403 može opisivati nedovoljan kredit, zabranjenu kupnju ili broj bez rezultata; pregledajte poruku.

Prije pristupa vrijednosti response.name provjerite i HTTP status i JSON polje status. Objekt odgovora može izostati u slučaju pogreške. Nedostatak imena ne smije spriječiti usmjeravanje uobičajenog poziva.

Naplata, ponovni pokušaji i razlika u odnosu na ažuriranje ID-a pozivatelja

Novi upit može uzrokovati naknadu za upit. Ova sučelja za upite ne dokumentiraju ključ idempotentnosti, pa ponovni pokušaj može biti drugi naplativi upit. Koristite ograničeni broj pokušaja s odgodom za pogreške prijenosa i usluge, najprije riješite pogreške računa i uskladite prijavljene naknade za upite. Podatke spremajte u predmemoriju samo tijekom razdoblja prikladnog vašoj aplikaciji; podaci o imenu pozivatelja mogu se promijeniti.

CNAM upit čita ime. Ne mijenja ime prikazano na vašim odlaznim pozivima. LIDB ažuriranje imena pozivatelja zasebna je operacija sa svojim poljima, autorizacijom, cijenom i obradom.

Vodič za CNAM integraciju na računu Zatražite pomoć oko integracije