Integrare CNAM
Referință API CNAM REST
Solicitați un nume de apelant prin HTTPS și gestionați rezultatul, taxa și erorile.
Alegeți comportamentul interogării
| Nivel | Preț public per interogare | Ce face |
|---|---|---|
| Starter | 0,0026 USD | Folosește informații proprii și din cache despre numele apelantului. |
| Standard | 0,0037 USD | Efectuează o interogare în timp real în rețea pentru fiecare cerere. |
| Mixed | 0,004 USD | Încearcă mai întâi o interogare în timp real, apoi revine la datele Starter atunci când nu se găsește niciun nume. |
Serviciul selectat determină comportamentul interogării; Mixed nu este o interogare care folosește mai întâi memoria cache. Verificați tariful atribuit contului dvs. înainte de utilizarea în producție. Numele unui apelant nu constituie dovada identității sau a dreptului de proprietate.
Trimiteți o interogare autentificată
Endpoint: GET https://api.multitel.net/v3/cnam/NUMBER. Folosiți cifre internaționale, inclusiv prefixul de țară, fără punctuație și fără semnul plus la început. Executați cererea de pe serverul aplicației dvs., folosind credențiale API aprobate.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Furnizați cele două variabile de mediu prin configurarea secretelor pe server. O credențială de tip bearer provizionată este o alternativă doar dacă acel acces este activat și restricțiile sale privind IP-ul sursă sunt respectate. Nu includeți niciodată un secret API într-un pachet public de browser.
Citiți răspunsul JSON
Acest răspuns este ilustrativ. Numele returnat și taxa depind de interogare și de serviciul selectat.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Cod de rezultat al aplicației; normalizați valorile de tip șir sau numeric înainte de a le compara cu 200.
status.msg- Mesajul însoțitor privind rezultatul sau respingerea.
response.number- Numărul interogat.
response.name- Numele apelantului disponibil.
response.cost- Taxa raportată pentru această interogare; tratați-o ca sumă zecimală.
response.balance- Soldul raportat al contului, când este prezent.
Rezultate fără nume și erori
O cerere reușită nu garantează un nume de apelant util. Tratați cazurile cu nume gol, cu număr returnat în locul unui nume și cu interogare respinsă. Codul de aplicație 403 poate indica credit insuficient, o achiziție interzisă sau un număr fără rezultat; verificați mesajul.
Verificați atât starea HTTP, cât și status din JSON înainte de a accesa response.name. Obiectul de răspuns poate lipsi în caz de eroare. Lipsa unui nume nu trebuie să împiedice rutarea apelului normal.
Facturare, reîncercări și diferența față de actualizarea ID-ului apelantului
O nouă interogare poate genera o taxă de interogare. Aceste interfețe de interogare nu documentează o cheie de idempotență, deci o reîncercare nouă poate fi a doua interogare facturabilă. Folosiți un backoff limitat pentru erorile de transport sau de serviciu, rezolvați mai întâi erorile de cont și reconciliați taxele de interogare raportate. Păstrați datele în cache doar pentru o perioadă adecvată aplicației dvs.; datele despre numele apelantului se pot schimba.
O interogare CNAM citește un nume. Ea nu modifică numele prezentat la apelurile dvs. efectuate. O actualizare a numelui apelantului în LIDB este o operațiune separată, cu câmpuri, autorizare, preț și procesare proprii.