Een opgeslagen prijsplan lezen
Nadat u door beschikbare telefoonnummers hebt gebladerd, zoekt u de prijsrijen op die voor uw API-account zijn opgeslagen. Gebruik de uuid van de prijsoptie uit de price-lijst van het geselecteerde nummer, niet het nummer zelf, de prefix-ID of de gebieds-ID. Houd het geselecteerde nummer en de prijsoptie bij elkaar.
Dit is een compatibiliteitsopzoeking van opgeslagen prijzen. Deze vernieuwt geen beschikbaarheid of prijzen, reserveert geen nummer, plaatst geen bestelling en garandeert niet het bedrag van een toekomstige aankoop. Controleer de prijsoptie die bij een nieuwe nummerzoekopdracht wordt geretourneerd voordat u bestelt.
Verzoek
Gebruik uw ingeschakelde API-account via HTTPS vanaf een toegestaan IP-adres. Stel PRICE_ID in op de exacte prijsoptie-ID die u hebt ontvangen. De methode leest één padargument en geen body-, datum- of pagineringsparameters.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Hetzelfde account dat de prijsoptie heeft verkregen, moet deze opzoeking uitvoeren. Stel geen ID zelf samen, gebruik geen databaserijnummer en vervang de selectie niet door die van een ander account. De verouderde methode vergelijkt alleen de zichtbare prijs-ID.
Antwoord
Het volgende fictieve voorbeeld toont alleen een selectie van velden die voor klanten bedoeld zijn. Werkelijke antwoorden retourneren volledige opgeslagen rijen en kunnen aanvullende account-, leveranciers- en interne prijsmetadata bevatten. Bewaar het volledige antwoord op uw server en toon alleen de klantgerichte waarden die uw toepassing nodig heeft.
{
"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 is een lijst, zelfs voor één rij. status.results telt de geretourneerde rijen. Numerieke databasewaarden kunnen strings zijn. Het eindpunt voegt geen valutaveld toe en rekent geen valuta's om; bevestig de factureringsvaluta van het account in plaats van deze uit dit voorbeeld af te leiden.
Prijsvelden
| Veld | Betekenis |
|---|---|
| visible_uuid | De zichtbare identificatie van de opgeslagen prijsoptie. Gebruik de oorspronkelijke optie-ID bij het koppelen van de opzoeking. |
| setup_price | Opgeslagen eenmalige installatieprijs voor deze optie. |
| monthly_price | Opgeslagen terugkerende maandelijkse prijs. |
| per_minute, free_minutes | Opgeslagen minuuttarief voor inkomende gesprekken en het aantal inbegrepen minuten. Deze geven geen prijsopgave voor uitgaande gesprekken of voor elke mogelijke toeslag. |
| channels | Opgeslagen aantal kanalen voor deze optie; dit is geen live capaciteits- of registratiecontrole. |
| yearly_price | Er kan een aanvullend opgeslagen veld voor de jaarprijs aanwezig zijn. Leid uit een maandprijs die niet nul is en een jaarveld dat nul is niet af dat het om een gratis jaarplan gaat. |
Meerdere overeenkomende rijen afhandelen
Een opzoeking kan meer dan één opgeslagen rij retourneren. De methode biedt geen gegarandeerde volgorde, geen selectie van de nieuwste rij en geen nummer-/prefixfilter. Kies niet stilzwijgend de eerste of de laatste rij. Vergelijk de geretourneerde context met het oorspronkelijk geselecteerde nummer en de prijsoptie; als het dubbelzinnig of verouderd blijft, vernieuw dan de nummerzoekopdracht in plaats van dit antwoord als een bestelofferte te behandelen.
De bestelcontroleworkflow van het portaal voert aanvullende selectie- en geldigheidscontroles uit. Ga er niet van uit dat deze verouderde opzoeking die controles implementeert of elke identificatie accepteert die het portaal accepteert.
Lege antwoorden en fouten
Als geen enkele opgeslagen rij overeenkomt, geeft de huidige handler geen JSON-resultaat en geen expliciet niet-gevonden-antwoord. Een lege body is geen nulprijs, geen beschikbaar plan en geen bevestigde geslaagde opzoeking. Controleer zowel het HTTP-antwoord als de JSON-structuur; bestel niet op basis van ontbrekende of niet-parseerbare prijsgegevens.
Ook authenticatie, bron-IP-beperkingen en databasestoringen kunnen een bruikbaar antwoord verhinderen. Er is geen handlerspecifieke foutenvelop voor een database-uitzondering. Vernieuw uw selectie of neem contact op met de ondersteuning wanneer een geauthenticeerde opzoeking onbeschikbaar blijft.
Effecten en beperkingen
De beoordeelde opzoeking voert een leesquery uit en bevat geen afschrijving, aankoop, reservering of vernieuwing van leveranciersprijzen. Het lezen van opgeslagen prijzen stelt geen huidige voorraad, regelgevende goedkeuring, aankooptoestemming van het account of definitieve facturering vast.