Helistaja nime päring

Helistaja nime päring

Hankige telefoninumbri kohta saadaolev helistaja nime päringu tulemus. Päring tehakse tootmiskeskkonnas ja selle eest võidakse teie kontolt tasu võtta ka siis, kui tulemus pärineb teenuse vahemälust. See ei muuda teile kuuluva numbri väljuvatel kõnedel kuvatavat nime.

Tagastatud nimi ei tõenda isikusamasust, omandiõigust ega helistamise luba. Nimed võivad puududa, olla aegunud või lühendatud; nende asemel võidakse kuvada geograafiline tähis või asendusväärtusena telefoninumber.

Päring

Kasutage oma aktiveeritud API kontot sellele lubatud lähte-IP-aadressilt. Hoidke autentimisandmeid serveripoolses saladuste hoidlas. Näites kasutatakse keskkonnamuutujaid ja väljamõeldud Põhja-Ameerika numbrit; ärge lisage autentimisandmeid URL-idesse ega avalikku brauserikoodi.

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

Esitage täielik number numbritena koos riigikoodiga, näiteks Põhja-Ameerika puhul üksteist numbrit, mis algavad numbriga 1. Ärge eeldage, et päringutöötleja normaliseerib kirjavahemärgid või plussmärgi. Päringu sisu ega piirkonnavalijat pole vaja. Kinnitage MultiTEL-iga, kas toetatud katvus sobib teie kavandatud kasutuseks.

Vastus

Väärtused on üksnes näitlikud; märgitud maksumus ei ole hinnapakkumine.

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

Tasud ja arveldusandmete võrdlemine

Nime sisaldavate tulemuste eest võetakse tasu kontole seadistatud CNAM hinna alusel. Korduspäringu või vahemälust vastatud päringu eest võidakse võtta uus tasu; idempotentsusvõtit ei pakuta. Enne automaatpäringute lubamist kontrollige konto kehtivat tariifi.

Vahemällu salvestatud tühja nime korral on vastusel teadaolev piirang: päringutöötleja võib tagastada API koodi 200 koos tühja nime, nullist erineva maksumuse ja vähendatud arvutatud saldoga, kuigi selles täitmisharus kontolt raha ei võeta. Ärge käsitage üksnes seda vastust tasu võtmise tõendina. Võrrelge andmeid konto arvelduskirjetega ja tehke uus saldopäring, ning ebaselgete tulemuste korral võtke ühendust klienditoega.

Ettemaksu kontroll nõuab praegu enne päringut vähemalt 0.004 suurust saldot, sõltumata seadistatud päringupõhisest hinnast. Tagasi lükatakse ka konto, mille ostud on keelatud. Need kontrollid ei tee sellest lõpp-punktist hinnapakkumise ega kulutuste piiramise API-t.

Vead ja korduskatsed

Kontrollige nii HTTP olekut kui ka JSON välju status.code/status.msg. API kood 403 võib tähendada ebapiisavat ettemaksusaldot, keelatud oste, konto autoriseerimisprobleemi või seda, et helistaja nime ei leitud. Nime puudumise täitmistee võib tagastada koodi stringina. Uurige teadet, selle asemel et pidada iga 403 põhjuseks valesid autentimisandmeid. Seadistuskonfliktide korral võidakse tagastada API kood 500.

Ajalõpp võib tekkida pärast tasulist päringut. Kasutage piiratud arvu korduskatseid kasvava ooteajaga ainult siis, kui see sobib teie rakendusele, ning võrrelge esmalt ebaselgete katsete andmeid arvelduskirjetega. Ärge korrake päringut üha uuesti, kui number on tagasi lükatud või tekkinud on konto õiguste või saldo viga. Vastuste vahemälu teie enda rakenduses võib vähendada korduspäringuid, kui järgitakse teie lepingut ja täpsusnõudeid.

Muud numbriga seotud toimingud

See lugemistoiming on eraldi väljuvatel kõnedel kuvatava nime või LIDB andmete uuendamisest, telefonikataloogi kirjest ja helistaja registreerimisest. Neil toimingutel on oma kohustuslikud väljad, autoriseerimisnõuded ja tasud. Kasutage numbrijaotuste katvuse päringut prefiksitabeli kontrollimiseks või numbrite otsingut tellimiseks saadaolevate numbrite leidmiseks. Ükski neist ei tõenda, et helistaja on see, kellena ta end esitleb.