Leggere un piano tariffario salvato
Consulta le righe di prezzo salvate per il tuo account API dopo aver sfogliato i numeri di telefono disponibili. Usa lo uuid dell’opzione di prezzo presente nell’elenco price del numero selezionato, non il suo numero, l’ID del prefisso o l’ID dell’area. Mantieni insieme il numero selezionato e l’opzione di prezzo.
Questa è una ricerca di compatibilità dei prezzi salvati. Non aggiorna la disponibilità o i prezzi, non riserva un numero, non effettua un ordine e non garantisce l’importo di un acquisto futuro. Verifica l’opzione di prezzo restituita con una nuova ricerca di numeri prima di ordinare.
Richiesta
Usa il tuo account API abilitato tramite HTTPS da un indirizzo IP consentito. Imposta PRICE_ID sull’ID esatto dell’opzione di prezzo che hai ricevuto. Il metodo legge un solo argomento di percorso e nessun parametro di corpo, data o paginazione.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Lo stesso account che ha ottenuto l’opzione di prezzo deve eseguire questa ricerca. Non costruire un ID, non usare un numero di riga del database e non sostituire la selezione di un altro account. Il metodo legacy confronta solo l’ID di prezzo visibile.
Risposta
L’esempio fittizio seguente mostra solo alcuni campi rivolti al cliente. Le risposte reali restituiscono righe salvate complete e possono includere ulteriori metadati di account, fornitore e prezzi interni. Conserva la risposta completa sul tuo server ed esponi solo i valori rivolti al cliente di cui la tua applicazione ha bisogno.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response è un elenco, anche per una sola riga. status.results conta le righe restituite. I valori numerici del database possono essere stringhe. L’endpoint non aggiunge un campo valuta né converte le valute; conferma la valuta di fatturazione dell’account invece di dedurla da questo esempio.
Campi di prezzo
| Campo | Significato |
|---|---|
| visible_uuid | L’identificatore visibile dell’opzione di prezzo salvata. Usa l’ID originale dell’opzione quando correli la ricerca. |
| setup_price | Prezzo di attivazione una tantum memorizzato per questa opzione. |
| monthly_price | Prezzo mensile ricorrente memorizzato. |
| per_minute, free_minutes | Tariffa al minuto memorizzata per le chiamate in entrata e quantità di minuti inclusi. Questi valori non quotano le chiamate in uscita né ogni possibile sovrapprezzo. |
| channels | Quantità di canali memorizzata per questa opzione; non è una verifica in tempo reale della capacità o della registrazione. |
| yearly_price | Può essere presente un ulteriore campo memorizzato per il prezzo annuale. Non dedurre che un prezzo mensile diverso da zero e un campo annuale pari a zero rappresentino un piano annuale gratuito. |
Gestire più righe corrispondenti
Una ricerca può restituire più di una riga salvata. Il metodo non fornisce alcun ordinamento garantito, selezione della riga più recente o filtro per numero/prefisso. Non scegliere silenziosamente la prima o l’ultima riga. Confronta il contesto restituito con il numero e l’opzione di prezzo selezionati in origine; se rimane ambiguo o obsoleto, ripeti la ricerca dei numeri invece di trattare questa risposta come un preventivo d’ordine.
Il flusso di revisione dell’ordine del portale esegue ulteriori controlli di selezione e validità. Non presumere che questa ricerca legacy implementi tali controlli o accetti ogni identificatore accettato dal portale.
Risposte vuote ed errori
Se nessuna riga salvata corrisponde, il gestore attuale non emette alcun risultato JSON né una risposta esplicita di elemento non trovato. Un corpo vuoto non è un prezzo pari a zero, un piano disponibile o una ricerca riuscita confermata. Controlla sia la risposta HTTP sia la struttura JSON; non ordinare a partire da dati di prezzo mancanti o non analizzabili.
Anche l’autenticazione, le restrizioni sull’IP di origine e gli errori del database possono impedire una risposta utilizzabile. Non esiste una busta di errore specifica del gestore per un’eccezione del database. Aggiorna la tua selezione o contatta l’assistenza quando una ricerca autenticata rimane non disponibile.
Effetti e limiti
La ricerca esaminata esegue una query di lettura e non contiene alcun addebito, acquisto, prenotazione o aggiornamento del prezzo del fornitore. Leggere i prezzi salvati non stabilisce l’inventario corrente, l’approvazione normativa, l’autorizzazione all’acquisto dell’account o la fatturazione finale.