Consulta le informazioni di instradamento
Richiedi informazioni di instradamento per un numero telefonico nordamericano. Usale per interpretare i dati disponibili sull'instradamento e sull'operatore, non come prova dell'identità dell'abbonato, della titolarità del numero, della sua raggiungibilità o della sua disponibilità per l'acquisto. Una ricerca può comportare un addebito sul tuo account.
Richiesta
Usa il tuo account API abilitato e l'indirizzo IP di origine autorizzato per tale account. Fornisci il numero completo in cifre, incluso il prefisso internazionale 1. L'esempio usa variabili d'ambiente e un numero fittizio. Il gestore non normalizza la punteggiatura; verifica la validità dei dati prima di inviarli.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123Risposta
Sono mostrati solo alcuni campi a scopo illustrativo; la loro disponibilità dipende dalla fonte e dal tipo di numero.
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}La ricerca standard converte in minuscolo i nomi dei campi restituiti. A seconda della fonte, possono essere presenti campi relativi all'operatore, al centro tariffario, alla località e alla giurisdizione. La risposta non costituisce una scheda completa dell'abbonato con una struttura fissa. L'indicatore local può essere il valore numerico 1 oppure la stringa 0. Il gestore calcola ported confrontando il numero di instradamento restituito con il numero telefonico fornito; non interpretarlo come una cronologia completa e verificata della portabilità.
Prezzo e nuovi tentativi
Il gestore esaminato addebita $0.00025 sull'account quando raggiunge il percorso di completamento e registra la ricerca. Il costo restituito è normalmente una stringa che include il simbolo del dollaro, anziché un semplice importo numerico. Non viene esposta alcuna chiave di idempotenza. Ripetere una richiesta può generare un altro addebito.
Per gli account prepagati, il codice verifica che il saldo sia almeno pari a 0.00025. Il messaggio di saldo insufficiente attualmente indica $5, un importo che non corrisponde a tale soglia. Interpreta l'errore come un rifiuto dovuto al saldo e verifica i fondi dell'account prima di riprovare.
Errori e successi incompleti
Controlla sia lo stato HTTP sia i campi status.code/status.msg del JSON. Un risultato vuoto della ricerca standard restituisce il codice API 404. Il codice API 403 può indicare un saldo prepagato insufficiente.
Un percorso di gestione degli errori attualmente presente per i numeri verdi può comunque addebitare l'importo della ricerca e segnalare il codice API 200 senza campi di instradamento utili; le informazioni sul costo possono essere incomplete. Il solo codice 200, quindi, non conferma che la ricerca sia utilizzabile. Verifica la validità dei campi necessari alla tua applicazione, confronta gli addebiti dubbi con i registri di fatturazione dell'account e contatta l'assistenza in caso di risultati incompleti.
Nell'implementazione esaminata, la gestione dei numeri verdi varia in base alla lunghezza del numero fornito. Usa preferibilmente il numero completo in cifre nel formato internazionale e verifica con l'assistenza la copertura necessaria per i numeri verdi. Non ripetere automaticamente la richiesta in caso di risultato malformato o incompleto e non basarti su una ricerca di instradamento per stabilire che sia sicuro o autorizzato chiamare un numero.