Conferma che l'inventario mobile è abilitato
Usa questa ricerca solo dopo che l'inventario di numeri mobili è stato abilitato per il tuo account cliente. Ottieni un prefisso mobile individuale aggiornato tramite il flusso di individuazione dell'account. Il percorso supportato richiede l'inventario wireless per quel prefisso. Non dipende da un record corrispondente di metadati di instradamento su rete fissa. Contatta l'assistenza se non sei sicuro che il tuo account o il tuo prefisso sia abilitato.
L'attuale route legacy non rifiuta in modo affidabile ogni richiesta non idonea. Un account senza inventario mobile abilitato può ricevere inventario ordinario mentre la risposta indica ancora info.is_mobile: 1. Anche un prefisso gratuito può raggiungere la sezione di inventario gratuito con quell'etichetta. Non usare quest'etichetta da sola per identificare il servizio mobile e non inviare prefissi ordinari o gratuiti a questo endpoint. Usa il catalogo mobile confermato dell'account e il flusso abilitato.
Mantieni ogni numero con la propria selezione di prezzo
Per ogni candidato, mantieni number, info.uuid e la lista price della stessa voce insieme. La risposta contiene anche metadati di prefisso/area/paese, termini contrattuali e restrizioni di registrazione. I candidati sono ordinati in base al prezzo mensile della prima opzione di prezzo, in ordine crescente; non esiste un ordine stabile garantito per prezzi uguali. Non sostituire l'ID del numero restituito con un ID di area o di prefisso, né abbinarlo all'ID prezzo di un altro candidato.
La risposta completa può includere campi aggiuntivi di metadati e di prezzo. I campi features, i valori dei canali e le restrictions restituite descrivono il candidato; non sono una garanzia che chiamate, SMS, MMS o fax siano già utilizzabili. Le autorizzazioni dell'account, la registrazione e il piano di servizio selezionato continuano ad applicarsi. Non trattare i segnaposto dell'esempio come ID o prezzi validi.
Usa una quantità piccola e positiva
Inizia con una quantità di 1. La normale richiesta al provider normalizza una quantità non positiva a 1 e limita il valore a monte a 300, ma la gestione successiva dei risultati usa comunque l'input originale. Una quantità zero può quindi richiedere inventario a monte e non restituire candidati. Altre sezioni legacy non applicano in modo coerente il numero di risultati richiesto. Non fare affidamento su un unico massimo universale né inviare valori negativi, frazionari o non numerici. Nessun filtro di ricerca pubblico supportato né parametro del body con ID prezzo è documentato per questa route.
Distingui la mancanza di stock da un errore di ricerca
Una risposta 404 può rappresentare inventario non disponibile, servizio disabilitato, ricerca del fornitore non riuscita o record di catalogo non validi. Considera un timeout o un errore del provider come disponibilità sconosciuta anziché come stock zero confermato. Aggiorna la selezione e riprova con backoff quando appropriato. Evita di interrogare ripetutamente ogni centrale. Il separato endpoint di conteggio dell'inventario mobile è un'indicazione basata su un'istantanea e non deve necessariamente corrispondere alla lunghezza della lista dei candidati di questo account.
Ricontrolla prima dell'acquisto
La ricerca non riserva stock. La sezione esaminata tenta di escludere i numeri già acquistati, ma una ricerca locale delle prenotazioni non riuscita può lasciare tale candidato nel risultato. Disponibilità, proprietà, prezzi approvati e registrazione devono essere verificati dal flusso di acquisto. Usa una selezione aggiornata con la richiesta di acquisto protetta e riconcilia l'inventario dell'account dopo qualsiasi risultato di acquisto incerto prima di riprovare. Non acquistare mai semplicemente perché è stato restituito un candidato.
Richiesta
Usa un account API abilitato via HTTPS da un indirizzo IP di origine consentito. Anche l'inventario mobile deve essere abilitato per l'account cliente; l'autenticazione API da sola non lo abilita.
GET con l'identificatore attuale del prefisso individuale e una quantità positiva intera nel percorso dell'URL. La quantità è impostata su 1 per impostazione predefinita se omessa. Usa l'esempio con 1; questa route non valida né impone in modo coerente un limite universale di risultati.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
prefix_id | string | Sì | L'ID visibile e opaco di un prefisso mobile individuale idoneo proveniente dall'individuazione. Usa un prefisso di centrale mobile NPA/NXX supportato dal tuo account; non sostituirlo con un ID di area, un ID di visualizzazione raggruppato, un prefisso di composizione letterale né un prefisso gratuito. |
quantity | integer | No | Numero di candidati richiesti. Impostato su 1 per impostazione predefinita. Fornisci un numero intero positivo modesto. La normale richiesta a monte limita la sua quantità a 300, ma ciò non è un input universalmente validato né una garanzia sulla dimensione della risposta. |
Risposta
Ispeziona status.code e status.msg nel corpo JSON oltre allo stato HTTP. In caso di successo, response è una lista di numeri candidati, status.msg è Results: seguito dal numero restituito e status.results è la lunghezza serializzata della lista. I prezzi dei candidati sono specifici dell'account. L'esempio abbreviato e illustrativo usa segnaposto invece di inventario reale o di un preventivo tariffario. I numeri contengono il prefisso internazionale senza segno più; gli identificatori sono stringhe opache.
Forma illustrativa della risposta; non sono dati reali dell'account né un preventivo attuale.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Errori
- 404: ID prefisso, paese o area non validi: aggiorna la selezione del prefisso mobile individuale.
- 404: Nessun numero trovato: può significare assenza di stock utilizzabile, servizio disabilitato, ricerca del provider non riuscita, selezione non supportata o limitazioni dell'account. Non è la prova di un conteggio autorevole di inventario zero.
Disponibilità ed effetti collaterali
- La ricerca non affitta né riserva un numero e il percorso esaminato non addebita un importo di acquisto. Contatta il provider di inventario e può richiedere tempo.
- Le ricerche riuscite scrivono voci di cache di numeri e prezzi relative all'account e log delle query. Ripetere una ricerca non è una prenotazione, un blocco del prezzo né un acquisto.
- I prezzi, i termini, le restrizioni e le capacità restituiti devono essere esaminati per l'account e il numero selezionati. Un'etichetta di funzionalità non stabilisce l'attivazione, l'approvazione della messaggistica né la funzionalità testata del servizio.