Integrazione CNAM
Riferimento API REST CNAM
Richiedi il nome di un chiamante tramite HTTPS e gestisci risultato, addebito ed errori.
Scegli il comportamento della ricerca
| Livello | Prezzo pubblico per query | Cosa fa |
|---|---|---|
| Starter | 0,0026 USD | Usa informazioni proprietarie e in cache sul nome del chiamante. |
| Standard | 0,0037 USD | Esegue una ricerca di rete in tempo reale per ogni query. |
| Mixed | 0,004 USD | Prova prima una ricerca in tempo reale, poi ripiega sui dati Starter quando non viene trovato alcun nome. |
Il servizio selezionato determina il comportamento della ricerca; Mixed non è una ricerca che consulta prima la cache. Verifica la tariffa assegnata al tuo account prima dell’uso in produzione. Il nome di un chiamante non è una prova di identità o di titolarità.
Invia una ricerca autenticata
Endpoint: GET https://api.multitel.net/v3/cnam/NUMBER. Usa cifre internazionali incluso il prefisso del paese, senza punteggiatura né il segno più iniziale. Esegui la richiesta dal server della tua applicazione usando credenziali API approvate.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Fornisci le due variabili d’ambiente tramite la configurazione dei segreti lato server. Una credenziale bearer assegnata è un’alternativa solo se tale accesso è abilitato e le relative restrizioni sull’IP di origine sono rispettate. Non inserire mai un segreto API in un bundle pubblico del browser.
Leggi la risposta JSON
Questa risposta è puramente illustrativa. Il nome restituito e l’addebito dipendono dalla ricerca e dal servizio selezionato.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Codice di risultato applicativo; normalizza i valori stringa o numerici prima di confrontarli con 200.
status.msg- Il messaggio di esito o di rifiuto associato.
response.number- Il numero interrogato.
response.name- Il nome del chiamante disponibile.
response.cost- L’addebito riportato per questa query; trattalo come un importo decimale.
response.balance- Il saldo dell’account riportato, quando presente.
Risultati senza nome ed errori
Una richiesta riuscita non garantisce un nome del chiamante utile. Gestisci un nome vuoto, un numero restituito al posto di un nome e una ricerca rifiutata. Il codice applicativo 403 può indicare credito insufficiente, un acquisto non consentito o un numero senza risultato; esamina il messaggio.
Controlla sia lo stato HTTP sia il status JSON prima di accedere a response.name. In caso di errore l’oggetto della risposta può essere assente. Un nome mancante non deve impedire l’instradamento della chiamata normale.
Fatturazione, nuovi tentativi e differenza rispetto all’aggiornamento del caller ID
Una nuova ricerca può comportare un addebito di query. Queste interfacce di ricerca non documentano una chiave di idempotenza, quindi un nuovo tentativo può essere una seconda query a pagamento. Usa un backoff limitato per i guasti di trasporto o di servizio, risolvi prima gli errori dell’account e riconcilia gli addebiti di query riportati. Memorizza i dati in cache solo per un periodo adatto alla tua applicazione; i dati sul nome del chiamante possono cambiare.
Una ricerca CNAM legge un nome. Non modifica il nome mostrato nelle tue chiamate in uscita. L’aggiornamento del nome del chiamante LIDB è un’operazione separata, con campi, autorizzazione, prezzo ed elaborazione propri.