Sužinoti skambintojo vardą

Gaukite prieinamą skambintojo vardą pagal telefono numerį. Ši užklausa vykdoma produkcinėje aplinkoje ir už ją gali būti nuskaičiuotos lėšos iš jūsų paskyros, net jei rezultatas gaunamas iš paslaugos podėlio. Ji nekeičia jums priklausančio numerio vardo, rodomo skambinant iš to numerio.

Grąžintas vardas nepatvirtina tapatybės, nuosavybės teisės ar leidimo skambinti. Vardo gali nebūti, jis gali būti pasenęs, sutrumpintas, vietovės pavadinimas arba vietoj jo gali būti pateiktas telefono numeris.

Užklausa

Naudokite savo įgalintą API paskyrą iš jai leidžiamo šaltinio IP adreso. Prisijungimo duomenis laikykite serverio pusėje esančioje slaptųjų duomenų saugykloje. Pavyzdyje naudojami aplinkos kintamieji ir išgalvotas Šiaurės Amerikos numeris; nedėkite prisijungimo duomenų į URL adresus ar viešai prieinamą naršyklėje vykdomą kodą.

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

Pateikite visą numerį skaitmenimis, įskaitant šalies kodą, pavyzdžiui, Šiaurės Amerikai skirtą vienuolikos skaitmenų numerį, prasidedantį 1. Nesitikėkite, kad užklausos apdorojimo programa normalizuos skyrybos ženklus ar pliuso ženklą. Užklausos turinio ar regiono parinkiklio nereikia. Dėl jūsų numatytam naudojimui palaikomos aprėpties pasitarkite su MultiTEL.

Atsakymas

Reikšmės pateiktos tik kaip pavyzdys; nurodyta kaina nėra kainos pasiūlymas.

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

Skambintojo vardo užklausos laukai
Laukas	Reikšmė
number	Numeris, dėl kurio pateikta užklausa.
name	Prieinamas vardas arba pakaitinis tekstas. Tai nėra tapatybės patvirtinimas.
cost	Šiuo vykdymo keliu grąžinama paskyrai ar paslaugai nustatyta užklausos kaina. Vadovaukitės dabartiniu paskyros įkainiu, o ne pavyzdyje pateikta reikšme.
balance	Atsakymui apskaičiuotas likutis. Tai nėra nauja transakcinė paskyros likučio užklausa.

Mokesčiai ir duomenų sutikrinimas

Už rezultatus su vardu taikoma paskyrai nustatyta CNAM kaina. Pakartotinė užklausa arba užklausa, kurios rezultatas gaunamas iš podėlio, gali būti apmokestinta dar kartą; idempotentiškumo raktas nesuteikiamas. Prieš įjungdami automatines užklausas, patikrinkite dabartinį paskyros įkainį.

Žinomas atsakymo apribojimas, kai podėlyje esantis vardas yra tuščias: užklausos apdorojimo programa gali grąžinti API kodą 200 su tuščiu vardu, nenuline kaina ir sumažintu apskaičiuotu likučiu, nors ši vykdymo šaka nenuskaičiuoja lėšų iš paskyros. Vien šio atsakymo nelaikykite apmokestinimo įrodymu. Sutikrinkite su paskyros atsiskaitymo įrašais ir naujai atliktos užklausos rezultatu: likučio užklausa; jei rezultatai neaiškūs, kreipkitės į pagalbos tarnybą.

Šiuo metu išankstinio mokėjimo patikra reikalauja, kad prieš užklausą likutis būtų bent 0.004, nepriklausomai nuo nustatytos vienos užklausos kainos. Užklausa taip pat atmetama, jei paskyroje išjungti pirkimai. Dėl šių patikrų šis galinis taškas netampa kainos pasiūlymų ar išlaidų ribojimo API.

Klaidos ir pakartotiniai bandymai

Tikrinkite ir HTTP būseną, ir JSON laukus status.code/status.msg. API kodas 403 gali reikšti nepakankamą išankstinio mokėjimo likutį, draudimą pirkti, paskyros autorizavimo problemą arba tai, kad skambintojo vardas nerastas. Vykdymo kelias, kai vardas nerastas, gali grąžinti kodą kaip eilutę. Perskaitykite pranešimą, užuot kiekvieną 403 laikę neteisingų prisijungimo duomenų požymiu. Dėl konfigūracijos konfliktų gali būti grąžintas API kodas 500.

Laukimo laikas gali baigtis jau atlikus apmokestinamą užklausą. Ribotą pakartotinių bandymų skaičių su didinamais laukimo intervalais naudokite tik tada, kai tai tinka jūsų programai, ir pirmiausia sutikrinkite neaiškios baigties bandymus. Nekartokite užklausų dėl atmesto numerio ar nesėkmės, susijusios su paskyros leidimais arba likučiu. Atsakymų podėlis jūsų programoje gali sumažinti pasikartojančių užklausų skaičių, jei tai atitinka jūsų sutartį ir tikslumo reikalavimus.

Kitos operacijos su numeriais

Ši skaitymo operacija yra atskira nuo išeinančio skambučio vardo / LIDB atnaujinimo, įtraukimo į abonentų katalogą ar skambintojo registravimo. Šioms operacijoms taikomi atskiri privalomi laukai, autorizavimas ir mokesčiai. Naudokite numerių paskirstymo aprėpties patikrą prefiksų lentelei patikrinti arba numerių paiešką užsakomiems numeriams rasti. Nė viena iš šių operacijų nepatvirtina, kad skambintojas yra tas, kuo prisistato.