CNAM-i integratsioon

CNAM REST API viide

Küsige helistaja nime HTTPS-i kaudu ning käsitlege tulemust, tasu ja vigu.

Valige päringu käitumine

Tase	Avalik hind päringu kohta	Mida see teeb
Starter	0,0026 $	Kasutab omandiõigusega kaitstud ja vahemällu salvestatud helistaja nime teavet.
Standard	0,0037 $	Teeb iga päringu jaoks reaalajas võrgupäringu.
Mixed	0,004 $	Proovib kõigepealt reaalajas päringut ja kasutab seejärel andmeid tasemelt Starter, kui nime ei leita.

Päringu käitumise määrab valitud teenus; Mixed ei ole vahemälu eelistav päring. Enne tootmiskasutust vaadake üle oma kontole määratud hind. Helistaja nimi ei ole isikusamasuse ega omandiõiguse tõend.

Saatke autenditud päring

Lõpp-punkt: GET https://api.multitel.net/v3/cnam/NUMBER. Kasutage rahvusvahelist telefoninumbrit koos riigikoodiga, ainult numbritest koosnevalt, ilma kirjavahemärkide ja alguses oleva plussita. Käivitage see oma rakendusserverist, kasutades heakskiidetud API autentimisandmeid.

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

Esitage need kaks keskkonnamuutujat serveripoolse saladuste konfiguratsiooni kaudu. Väljastatud bearer-autentimisandmed on alternatiiv ainult siis, kui see ligipääs on lubatud ja selle lähte-IP piirangud on täidetud. Ärge kunagi pange API saladust avalikku brauseripaketti.

API autentimise ja esimese päringu juhend

Lugege JSON-vastust

See vastus on illustratiivne. Tagastatav nimi ja tasu sõltuvad päringust ja valitud teenusest.

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

status.code: Rakenduse tulemuskood; normaliseerige sõne- ja arvväärtused enne võrdlemist väärtusega 200.
status.msg: Kaasnev tulemuse- või tagasilükkamisteade.
response.number: Number, mille kohta päring tehti.
response.name: Saadaolev helistaja nimi.
response.cost: Selle päringu eest teatatud tasu; käsitlege seda kümnendsummana.
response.balance: Teatatud konto saldo, kui see on olemas.

Nimeta tulemused ja vead

Edukas päring ei taga kasulikku helistaja nime. Käsitlege tühja nime, nime asemel tagastatud numbrit ja tagasi lükatud päringut. Rakenduse kood 403 võib tähendada ebapiisavat krediiti, keelatud ostu või numbrit, millele tulemust ei ole; vaadake sõnumit.

Kontrollige enne välja response.name lugemist nii HTTP olekut kui ka JSON-i välja status. Vastuse objekt võib vea korral puududa. Puuduv nimi ei tohiks takistada tavalise kõne marsruutimist.

Arveldamine, kordused ja erinevus helistaja ID värskendamisest

Uus päring võib kaasa tuua päringutasu. Need päringuliidesed ei dokumenteeri idempotentsusvõtit, seega võib uus kordus olla teine tasuline päring. Kasutage transpordi- või teenusevigade korral piiratud ooteaja pikendamist, lahendage kõigepealt kontoveed ja ühitage teatatud päringutasud. Salvestage vahemällu ainult teie rakendusele sobivaks ajaks; helistaja nime andmed võivad muutuda.

CNAM-i päring loeb nime. See ei muuda nime, mida teie väljaminevatel kõnedel esitatakse. LIDB helistaja nime värskendus on eraldi toiming oma väljade, volituse, hinna ja töötlemisega.

Konto CNAM-i integreerimisjuhend Hankige integreerimisabi