Zvanītāja vārda meklēšana

Zvanītāja vārda meklēšana

Iegūstiet tālruņa numuram pieejamo zvanītāja vārda meklēšanas rezultātu. Šī meklēšana notiek produkcijas vidē, un par to var tikt iekasēta maksa no jūsu konta, arī tad, ja rezultāts tiek iegūts no pakalpojuma kešatmiņas. Tā nemaina izejošajos zvanos rādīto vārdu numuram, kas jums pieder.

Atgrieztais vārds nav identitātes, īpašumtiesību vai atļaujas zvanīt apliecinājums. Vārdi var nebūt pieejami, būt novecojuši vai saīsināti; to vietā var būt ģeogrāfisks apzīmējums vai kā aizstājējvērtība norādīts tālruņa numurs.

Pieprasījums

Izmantojiet savu aktivizēto API kontu no tam atļautās avota IP adreses. Glabājiet piekļuves datus servera puses slepeno datu glabātuvē. Piemērā tiek izmantoti vides mainīgie un izdomāts Ziemeļamerikas numurs; neievietojiet piekļuves datus URL adresēs vai publiski pieejamā pārlūka kodā.

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

Norādiet pilnu numuru tikai ar cipariem, ieskaitot valsts kodu, piemēram, Ziemeļamerikai vienpadsmit ciparus, kas sākas ar 1. Nepaļaujieties uz to, ka apstrādātājs normalizēs pieturzīmes vai plusa zīmi. Nav nepieciešams pieprasījuma pamatteksts vai reģiona atlasītājs. Noskaidrojiet pie MultiTEL, vai atbalstītais pārklājums atbilst jūsu paredzētajam lietojumam.

Atbilde

Vērtības ir tikai ilustratīvas; norādītās izmaksas nav cenas piedāvājums.

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

Maksas un datu salīdzināšana

Par rezultātiem, kuros ir vārds, tiek iekasēta maksa atbilstoši kontam konfigurētajai CNAM cenai. Atkārtota meklēšana vai meklēšana kešatmiņā var radīt vēl vienu maksu; idempotences atslēga nav pieejama. Pirms automatizētas meklēšanas iespējošanas pārbaudiet konta pašreizējo tarifu.

Atbildei ir zināms ierobežojums, ja kešatmiņā saglabātais vārds ir tukšs: apstrādātājs var atgriezt API kodu 200 ar tukšu vārdu, izmaksām, kas nav nulle, un samazinātu aprēķināto atlikumu, lai gan šajā izpildes zarā nauda no konta netiek atskaitīta. Neuzskatiet tikai šo atbildi par pierādījumu maksas iekasēšanai. Salīdziniet datus ar konta norēķinu ierakstiem un jaunu atlikuma vaicājumu, un neskaidru rezultātu gadījumā sazinieties ar atbalsta dienestu.

Priekšapmaksas pārbaude pašlaik pieprasa, lai pirms meklēšanas atlikums būtu vismaz 0.004 neatkarīgi no konfigurētās cenas par vaicājumu. Tiek noraidīts arī konts, kurā pirkumi ir atspējoti. Šīs pārbaudes nepadara šo galapunktu par cenu piedāvājumu vai tēriņu ierobežošanas API.

Kļūdas un atkārtoti mēģinājumi

Pārbaudiet gan HTTP statusu, gan JSON laukus status.code/status.msg. API kods 403 var nozīmēt nepietiekamu priekšapmaksas atlikumu, aizliegtus pirkumus, konta autorizācijas problēmu vai to, ka zvanītāja vārds nav atrasts. Izpildes ceļš, kurā vārds nav atrasts, var atgriezt kodu kā virkni. Pārbaudiet ziņojumu, nevis uzskatiet katru 403 par nepareiziem piekļuves datiem. Konfigurācijas konfliktu gadījumā var tikt atgriezts API kods 500.

Taimauts var iestāties pēc meklēšanas, par kuru tiek iekasēta maksa. Izmantojiet ierobežotu atkārtotu mēģinājumu skaitu ar pieaugošu gaidīšanas laiku tikai tad, ja tas ir piemēroti jūsu lietotnei, un vispirms salīdziniet neskaidro mēģinājumu datus ar norēķinu ierakstiem. Neatkārtojiet pieprasījumus atkal un atkal, ja numurs ir noraidīts vai radusies konta atļauju vai atlikuma kļūda. Atbilžu kešatmiņa jūsu lietotnē var samazināt atkārtotu pieprasījumu skaitu, ievērojot jūsu līgumu un precizitātes prasības.

Citas darbības ar numuriem

Šī lasīšanas darbība ir atsevišķa no izejošajos zvanos rādītā vārda vai LIDB datu atjaunināšanas, ieraksta tālruņu uzziņu sarakstā vai zvanītāja reģistrācijas. Šīm darbībām ir savi obligātie lauki, autorizācijas prasības un maksas. Izmantojiet numuru piešķīrumu pārklājumu prefiksu tabulas pārbaudei vai numuru meklēšanu pasūtīšanai pieejamo numuru atrašanai. Neviena no šīm darbībām neapliecina, ka zvanītājs ir tas, par ko uzdodas.