Les en lagret prisplan
Når du har bladd gjennom tilgjengelige telefonnumre, slår du opp prisradene som er lagret for API-kontoen din. Bruk prisalternativets uuid fra det valgte nummerets price liste, ikke nummeret, prefiks-ID-en eller område-ID-en. Hold det valgte nummeret og prisalternativet sammen.
Dette er et kompatibilitetsoppslag av lagret prissetting. Det oppdaterer ikke tilgjengelighet eller priser, reserverer ikke et nummer, legger ikke inn en bestilling og garanterer ikke beløpet for et fremtidig kjøp. Gå gjennom prisalternativet som returneres med et nytt nummersøk før du bestiller.
Forespørsel
Bruk den aktiverte API-kontoen din over HTTPS fra en tillatt IP-adresse. Sett PRICE_ID til nøyaktig den prisalternativ-ID-en du mottok. Metoden leser ett stiargument og ingen body-, dato- eller pagineringsparametere.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Den samme kontoen som hentet prisalternativet, må utføre dette oppslaget. Ikke konstruer en ID, ikke bruk et databaseradnummer, og ikke bytt inn en annen kontos valg. Den eldre metoden matcher bare den synlige pris-ID-en.
Svar
Det følgende fiktive eksemplet viser bare utvalgte kunderettede felt. Faktiske svar returnerer komplette lagrede rader og kan inneholde ytterligere metadata om konto, leverandør og intern prissetting. Behold hele svaret på serveren din, og eksponer bare de kunderettede verdiene applikasjonen din trenger.
{
"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 er en liste, selv for én rad. status.results teller de returnerte radene. Numeriske databaseverdier kan være strenger. Endepunktet legger ikke til et valutafelt og konverterer ikke valutaer; bekreft kontoens faktureringsvaluta i stedet for å utlede den fra dette eksemplet.
Prisfelt
| Felt | Betydning |
|---|---|
| visible_uuid | Det lagrede prisalternativets synlige identifikator. Bruk den opprinnelige alternativ-ID-en når du korrelerer oppslaget. |
| setup_price | Lagret engangs etableringspris for dette alternativet. |
| monthly_price | Lagret løpende månedspris. |
| per_minute, free_minutes | Lagret minuttpris for innkommende samtaler og antall inkluderte minutter. Disse gir ikke pris for utgående samtaler eller alle mulige tilleggsgebyrer. |
| channels | Lagret antall kanaler for dette alternativet; det er ikke en sanntidskontroll av kapasitet eller registrering. |
| yearly_price | Et ekstra lagret årsprisfelt kan være til stede. Ikke anta at en månedspris ulik null og et årsfelt lik null representerer en gratis årsplan. |
Håndter flere samsvarende rader
Et oppslag kan returnere mer enn én lagret rad. Metoden gir ingen garantert rekkefølge, ingen utvelgelse av nyeste rad og ingen nummer-/prefiksfilter. Ikke velg den første eller siste raden stilltiende. Sammenlign den returnerte konteksten med det opprinnelig valgte nummeret og prisalternativet; hvis det fortsatt er tvetydig eller utdatert, kjør nummersøket på nytt i stedet for å behandle dette svaret som et bestillingstilbud.
Portalens arbeidsflyt for bestillingsgjennomgang utfører ytterligere utvelgelses- og gyldighetskontroller. Ikke anta at dette eldre oppslaget implementerer disse kontrollene eller godtar alle identifikatorer portalen godtar.
Tomme svar og feil
Hvis ingen lagret rad samsvarer, sender den nåværende behandleren ut verken et JSON-resultat eller et eksplisitt ikke-funnet-svar. En tom body er ikke en nullpris, en tilgjengelig plan eller et bekreftet vellykket oppslag. Kontroller både HTTP-svaret og JSON-strukturen; ikke bestill basert på manglende eller uparserbare prisdata.
Autentisering, kilde-IP-begrensninger og databasefeil kan også hindre et brukbart svar. Det finnes ingen behandlerspesifikk feilkonvolutt for et databaseunntak. Oppdater valget ditt eller kontakt kundestøtte når et autentisert oppslag fortsatt er utilgjengelig.
Effekter og begrensninger
Det gjennomgåtte oppslaget utfører en lesespørring og inneholder ingen belastning, kjøp, reservasjon eller oppdatering av leverandørpris. Lesing av lagret prissetting fastslår ikke gjeldende beholdning, regulatorisk godkjenning, kontoens kjøpstillatelse eller endelig fakturering.