Documentazione dell’API REST
API REST di ricerca dell’instradamento LRN
Cerca il numero di instradamento e le informazioni disponibili sull’operatore per un numero di telefono nordamericano a un prezzo fisso.
Scegli insieme l’API e la credenziale
Gli account approvati per Sviluppatori e Automazione, Aziende e Fornitori di comunicazioni possono integrare i servizi abilitati. Uno sviluppatore individuale non deve fingere di essere un’azienda. Gli SMS/MMS delle applicazioni richiedono l’approvazione all’invio e la registrazione previste. Il servizio per Privati e famiglie non offre un’API di invio dei messaggi accessibile ai clienti.
| Famiglia di API | URL di base | Autenticazione e risultato |
|---|---|---|
| Comunicazioni v3 | https://api.multitel.net/v3 | Credenziali Basic approvate; token predisposti idonei solo per le operazioni che li supportano. JSON status e response. |
| Registrazione per le emergenze | https://api.multi.tel/emergency | Credenziali Basic approvate oppure accesso bearer predisposto in modo specifico. JSON code, message e data. |
| Integrazioni REST del portale | Host e operazione indicati nel riferimento per sviluppatori del tuo account | Usa la credenziale, gli ambiti e lo schema documentati per quell’operazione. Le richieste di sessione del browser costituiscono una superficie separata. |
Imposta MULTITEL_API_USERNAME e MULTITEL_API_PASSWORD tramite la configurazione dei segreti del tuo server prima di usare gli esempi. Non inserirli mai nel JavaScript pubblico del browser, negli URL o nel controllo del codice sorgente. Le credenziali dedicate si gestiscono nelle impostazioni di integrazione API.
Cercare un numero
GET /v3/lrn/{number} accetta il numero di destinazione nel percorso. Per le informazioni che dipendono dall’origine si può indicare un numero di origine facoltativo come /v3/lrn/{number}/{ani}. Usa cifre nordamericane con il prefisso internazionale ove applicabile; gli esempi usano numeri fittizi riservati.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"Eseguire una ricerca con credenziali valide è a pagamento. La tariffa è 0,00025 USD per ricerca: 0,25 USD ogni 1000 oppure 250 USD per milione. Non sono previsti sconti per volume. Si tratta di una ricerca di informazioni di instradamento; non effettua alcuna chiamata telefonica.
Leggere il risultato
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}Questo esempio inventato mostra solo la struttura della risposta; non è un risultato di instradamento misurato. Controlla status.code prima di usare response. Il campo cost è una stringa preceduta dalla valuta, non un numero JSON.
| Campo | Significato |
|---|---|
lrn | Location Routing Number usato per identificare la destinazione di instradamento. |
ported | Indicatore di portabilità fornito da questa ricerca: in genere 0 o 1. Non usarlo come prova di titolarità o di idoneità al servizio. |
ocn | Operating Company Number, quando fornito. |
lata | Local Access and Transport Area, quando fornita. |
rc | Rate center, quando fornito. |
city, state, lec, lectype, jurisdiction, local | Ulteriori dettagli su località, operatore o origine, quando disponibili. Possono essere assenti o vuoti. |
Non pretendere che tutti i campi di instradamento siano presenti. In particolare, i risultati per numeri verdi possono omettere i dettagli del rate center locale e del codice operatore. Un LRN restituito non è una garanzia in tempo reale di raggiungibilità né un test della qualità della chiamata.
Usare le ricerche nel flusso di instradamento
- Convalida e normalizza il numero richiesto prima di inviarlo.
- Controlla lo stato HTTP e quello applicativo. Conserva una registrazione oscurata del numero, dell’ora e del risultato per la risoluzione dei problemi.
- Usa solo i campi rilevanti per la tua regola di instradamento e gestisci esplicitamente i valori assenti.
- Limita i nuovi tentativi dopo una risposta incerta. Ripetere una ricerca può generare un altro addebito; questo endpoint non ha una chiave di idempotenza documentata.
Consulta il prodotto LRN e il prezzo fisso. Il percorso OpenAPI pubblico include un segmento ANI; l’implementazione LRN distribuita accetta anche la richiesta più breve senza ANI. lrninfo è un’operazione distinta e non va usata al posto di questo endpoint.
Gestire errori e nuovi tentativi
- Errore di autenticazione o di autorizzazione
- Verifica lo stato di abilitazione della credenziale API, il servizio consentito e la restrizione sull’IP di origine. Il cookie di sessione del portale non è una credenziale di integrazione.
- Credito insufficiente o approvazione mancante
- Risolvi il problema del saldo dell’account, dell’approvazione all’invio o del requisito documentale prima di ripetere l’operazione.
- Nessun risultato
- Gestisci un inventario vuoto o un nome del chiamante mancante come un esito ordinario. Non dare per scontato che un numero sintatticamente valido disponga di tutti i servizi.
- Timeout di rete o guasto del servizio
- Per le letture usa tentativi limitati con backoff. Per un acquisto, un invio o una registrazione, controlla prima lo stato dell’operazione: ripetere una richiesta già accettata può duplicare un’azione a pagamento.
Il supporto all’idempotenza dipende da ciascuna famiglia di API. L’API per le emergenze supporta chiavi di ripetizione; questo non rende idempotenti richieste v3 arbitrarie. Conserva marcature temporali, ID restituiti e risposte oscurate per l’assistenza.
Continua con il riferimento del tuo account
Il riferimento dopo l’accesso filtra le operazioni in base alle tue autorizzazioni e ai servizi abilitati. Usa l’host esatto, il tipo di credenziale, i campi della richiesta e lo schema della risposta che indica. Le console possono eseguire operazioni reali, inclusi acquisti e messaggi.