Scegli un prefisso supportato
Usa un prefisso mobile individuale aggiornato ottenuto dalla discovery. Questo endpoint è destinato alle centrali telefoniche NANPA: un NPA identifica il prefisso di area e un NXX identifica la centrale telefonica. Un prefisso con solo il prefisso di area è troppo ampio. Non inviare ID di visualizzazione raggruppati né dedurre il supporto per un altro paese perché il suo prefisso contiene cifre sufficienti.
Usa il conteggio come indizio
Leggi response.count, con response.npa e response.nxx che identificano la centrale telefonica. Questo è uno snapshot del servizio di copertura, non scorta detenuta per il tuo account. Conferma i numeri effettivi, le quotazioni applicabili ed eventuali requisiti di registrazione prima di ordinare. Un conteggio riuscito non autorizza mai un acquisto.
Distingui la scorta zero da una ricerca non riuscita
Un conteggio riuscito pari a zero è diverso da un errore API. Esamina status.code e status.msg oltre allo stato HTTP. Tratta un timeout o una ricerca non riuscita come disponibilità sconosciuta e riprova più tardi con backoff.
Richiesta
Usa le credenziali del tuo account API abilitato tramite HTTPS. L'autenticazione Basic e i bearer token degli account API abilitati sono supportati; si applicano restrizioni sull'account.
GET con l'identificatore del prefisso nel percorso URL. Non ci sono parametri di query o di body documentati.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
prefix_id | string | Sì | Copia l'ID del prefisso individuale dalla risposta di discovery. Usa un prefisso mobile NANPA supportato contenente un prefisso di area (NPA) e una centrale telefonica (NXX), non un ID di solo prefisso di area né un ID di riepilogo raggruppato. Tratta l'identificatore come opaco. |
Risposta
Verifica status.code nel corpo JSON oltre allo stato HTTP. Una response riuscita ha status.code 200 e status.msg Results. response è un oggetto, non una lista: count è un intero che rappresenta lo snapshot dell'inventario; npa e nxx sono stringhe di tre caratteri. status.results non è presente per questo oggetto associativo. Un conteggio di 0 significa che la ricerca di copertura non ha trovato alcuna centrale telefonica corrispondente o ha restituito scorta zero; non dimostra che tutti i fornitori o le altre rotte di discovery non abbiano numeri.
Forma di risposta illustrativa; non sono dati reali dell'account né una quotazione attuale.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Errori
- 404: Provider disabilitato: la copertura dell'inventario mobile non è disponibile sul servizio.
- 404: ID prefisso non valido: ottieni un ID prefisso individuale aggiornato dalla discovery.
- 404: Prefisso non valido: il prefisso memorizzato non contiene cifre sufficienti per una ricerca NPA/NXX.
- 500: Copertura dell'inventario non riuscita: la ricerca a monte non ha restituito un risultato di copertura riuscito. Riprova più tardi con backoff; un errore non è un conteggio di scorta zero.
Disponibilità ed effetti collaterali
- L'operazione verifica l'inventario e non effettua un ordine, non riserva numeri né addebita un importo di acquisto.
- La scorta può cambiare immediatamente. Il conteggio di copertura non viene adattato per promettere l'acquistabilità specifica dell'account o la stessa lunghezza della risposta della successiva ricerca di numeri.
- Una ricerca contatta il servizio di copertura e può richiedere tempo. Non eseguire polling ripetuti su ogni prefisso, né trattare un timeout/errore come scorta zero riuscita.