Verifica la copertura della tabella delle assegnazioni
Verifica se un numero nordamericano corrisponde a un prefisso nella tabella delle assegnazioni di MultiTEL e recupera la città, lo stato e il paese associati. Si tratta di una ricerca in una tabella di prefissi. Non dimostra che un abbonato sia attivo, che un numero sia assegnato, che appartenga al tuo account o che tu possa ordinarlo.
Richiesta
Usa il tuo account API abilitato e un indirizzo IP di origine autorizzato. L’esempio usa credenziali HTTP Basic ricavate da variabili d’ambiente e un numero fittizio. Non è richiesto un corpo della richiesta.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Usa preferibilmente un numero nordamericano di undici cifre che inizi con 1. Il gestore rimuove i caratteri non numerici e antepone 1 a un valore di dieci cifre. I valori con un numero diverso di cifre vengono rifiutati. Questa normalizzazione non verifica tutte le regole della numerazione nordamericana, quindi una corrispondenza nella tabella non costituisce una convalida esaustiva del numero.
Risposta
I valori dei campi sono puramente illustrativi; non si tratta di un risultato ottenuto dalla tabella delle assegnazioni in uso.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Campo | Significato |
|---|---|
| number | Valore di ingresso normalizzato composto solo da cifre. |
| npanxx | Il prefisso memorizzato che corrisponde al numero. Il gestore dà la precedenza a un prefisso di sette cifre composto dai codici di paese, area e centrale e, in alternativa, può usare un prefisso di quattro cifre composto dai codici di paese e area; non dare per scontato che questo campo identifichi sempre una centrale completa. |
| city, state, country | Metadati relativi al prefisso di assegnazione corrispondente. Questi campi non identificano la posizione fisica attuale di un abbonato né il suo operatore attuale dopo la portabilità del numero. |
Errori
Leggi nel JSON il campo status.code anziché basarti soltanto sullo stato HTTP 200. Il codice API 404 con il messaggio Not part of NANPA indica che non è stata trovata alcuna corrispondenza con un prefisso nella tabella usata dal servizio; non costituisce una determinazione definitiva da parte di un’autorità di numerazione a livello mondiale. Il codice API 500 viene usato quando il numero di cifre non è valido o il numero manca.
Costi e passaggi successivi
Il gestore esaminato esegue una query sulla tabella locale delle assegnazioni e non prevede addebiti sull’account né ricerche esterne. Questo gestore non applica alcun costo di ricerca. Usa la ricerca dei numeri disponibili per trovare i numeri disponibili per l’ordine. Una ricerca del nome, una ricerca di instradamento o un ordine di un numero costituiscono operazioni distinte, ciascuna con le proprie tariffe previste per l’account.