Căutați numele unui apelant

Obțineți un rezultat disponibil privind numele apelantului pentru un număr de telefon. Această căutare se efectuează în mediul de producție și poate genera o taxă în contul dumneavoastră, inclusiv atunci când rezultatul provine din memoria cache a serviciului. Nu modifică numele afișat la apelurile efectuate de la un număr pe care îl dețineți.

Un nume returnat nu reprezintă o identitate verificată, o dovadă a deținerii numărului sau o permisiune de a apela. Numele pot lipsi, pot fi neactualizate sau abreviate, pot fi denumiri geografice ori pot fi înlocuite cu numărul de telefon.

Cerere

Utilizați contul dumneavoastră API activat de la adresa IP sursă permisă pentru acesta. Păstrați datele de autentificare într-un spațiu de stocare a secretelor pe server. Exemplul folosește variabile de mediu și un număr fictiv din America de Nord; nu introduceți datele de autentificare în URL-uri sau în cod public executat în browser.

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

Furnizați numărul complet folosind cifre, inclusiv codul de țară, de exemplu unsprezece cifre începând cu 1 pentru America de Nord. Nu vă bazați pe componenta care procesează cererea pentru a normaliza semnele de punctuație sau semnul plus. Nu sunt necesare un corp al cererii sau un selector de regiune. Confirmați cu MultiTEL acoperirea disponibilă pentru utilizarea dorită.

Răspuns

Valorile sunt doar ilustrative; costul nu reprezintă o ofertă de preț.

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

Câmpurile căutării numelui apelantului
Câmp	Semnificație
number	Numărul solicitat.
name	Numele disponibil sau textul alternativ. Nu reprezintă o verificare a identității.
cost	Prețul căutării configurat pentru cont/serviciu, raportat de acest flux de procesare. Folosiți tariful curent al contului, nu valoarea ilustrativă.
balance	Soldul calculat pentru răspuns. Nu reprezintă o interogare tranzacțională nouă a soldului contului.

Taxe și reconciliere

Rezultatele care conțin un nume sunt taxate la prețul CNAM configurat pentru cont. O căutare repetată sau servită din memoria cache poate genera o altă taxă; nu este pusă la dispoziție nicio cheie de idempotență. Verificați tariful curent al contului înainte de a activa căutările automate.

Există o limitare cunoscută a răspunsului atunci când numele din memoria cache este gol: componenta care procesează cererea poate returna codul API 200 cu un nume gol, un cost diferit de zero și un sold calculat redus, deși acea ramură de procesare nu debitează contul. Nu considerați acest răspuns, luat separat, drept dovadă a unei taxări. Reconciliați rezultatul cu evidențele de facturare ale contului și cu o nouă interogare a soldului, iar pentru rezultate ambigue contactați serviciul de asistență.

Verificarea creditului preplătit impune în prezent un sold de cel puțin 0.004 înainte de căutare, indiferent de prețul configurat per interogare. Este respins și un cont cu achizițiile dezactivate. Aceste verificări nu transformă acest punct de acces într-o API pentru oferte de preț sau limitarea cheltuielilor.

Erori și reîncercări

Verificați atât starea HTTP, cât și câmpurile status.code/status.msg din JSON. Codul API 403 poate indica un credit preplătit insuficient, achiziții interzise, o problemă de autorizare a contului sau faptul că nu s-a găsit niciun nume de apelant. Fluxul fără nume poate returna codul ca șir de caractere. Examinați mesajul în loc să interpretați fiecare cod 403 drept date de autentificare incorecte. Conflictele de configurare pot returna codul API 500.

Timpul de așteptare poate expira după o căutare taxabilă. Folosiți un număr limitat de reîncercări, cu intervale de așteptare progresive, numai dacă acest lucru este adecvat aplicației dumneavoastră și reconciliați mai întâi încercările cu rezultat incert. Nu reîncercați în mod repetat un număr respins sau o cerere eșuată din cauza permisiunilor ori a soldului contului. O memorie cache pentru răspunsuri în propria aplicație poate reduce cererile repetate, cu respectarea acordului dumneavoastră și a cerințelor de exactitate.

Alte operațiuni asupra numerelor

Această operațiune de citire este distinctă de actualizarea numelui afișat la apelurile efectuate/LIDB, de înscrierea într-un registru telefonic sau de înregistrarea apelantului. Aceste operațiuni au propriile câmpuri obligatorii, cerințe de autorizare și taxe. Folosiți acoperirea alocărilor pentru verificarea în tabelul de prefixe sau căutarea numerelor pentru inventarul de numere care pot fi comandate. Niciuna dintre aceste operațiuni nu dovedește că un apelant este persoana care pretinde că este.