Læs en gemt prisplan
Slå prisrækker op, der er gemt for din API-konto, efter at du har gennemset tilgængelige telefonnumre. Brug prisvalgets uuid fra listen price for det valgte nummer, ikke dets nummer, præfiks-ID eller område-ID. Hold det valgte nummer og prisvalget sammen.
Dette er et kompatibilitetsopslag af gemte priser. Det opdaterer ikke tilgængelighed eller priser, reserverer ikke et nummer, afgiver ikke en ordre og garanterer ikke beløbet for et fremtidigt køb. Gennemgå det prisvalg, der returneres ved en ny nummersøgning, før du bestiller.
Forespørgsel
Brug din aktiverede API-konto over HTTPS fra en tilladt IP-adresse. Sæt PRICE_ID til præcis det prisvalgs-ID, du modtog. Metoden læser ét stiargument og ingen body-, dato- eller pagineringsparametre.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Den samme konto, som fik prisvalget, skal udføre dette opslag. Konstruer ikke et ID, brug ikke et databaserækkenummer, og erstat ikke med en anden kontos valg. Den ældre metode matcher kun det synlige pris-ID.
Svar
Følgende fiktive eksempel viser kun udvalgte kundevendte felter. Faktiske svar returnerer komplette gemte rækker og kan indeholde yderligere konto-, leverandør- og interne prismetadata. Behold det fulde svar på din server, og eksponer kun de kundevendte værdier, som din applikation har brug for.
{
"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 række. status.results tæller de returnerede rækker. Numeriske databaseværdier kan være strenge. Endpointet tilføjer ikke et valutafelt og konverterer ikke valutaer; bekræft kontoens faktureringsvaluta i stedet for at udlede den fra dette eksempel.
Prisfelter
| Felt | Betydning |
|---|---|
| visible_uuid | Det gemte prisvalgs synlige identifikator. Brug det oprindelige valg-ID, når du korrelerer opslaget. |
| setup_price | Gemt engangspris for oprettelse for dette valg. |
| monthly_price | Gemt tilbagevendende månedlig pris. |
| per_minute, free_minutes | Gemt minuttakst for indgående opkald og antal inkluderede minutter. Disse angiver ikke priser for udgående opkald eller alle mulige tillæg. |
| channels | Gemt antal kanaler for dette valg; det er ikke en live kapacitets- eller registreringskontrol. |
| yearly_price | Et yderligere gemt felt for årlig pris kan være til stede. Udled ikke, at en månedlig pris forskellig fra nul og et årligt felt på nul repræsenterer en gratis årlig plan. |
Håndter flere matchende rækker
Et opslag kan returnere mere end én gemt række. Metoden giver ingen garanteret sortering, intet valg af nyeste række og intet nummer-/præfiksfilter. Vælg ikke stiltiende den første eller sidste række. Sammenlign den returnerede kontekst med det oprindeligt valgte nummer og prisvalg; hvis det forbliver tvetydigt eller forældet, så opdater nummersøgningen i stedet for at behandle dette svar som et ordretilbud.
Portalens arbejdsgang for ordregennemgang udfører yderligere valg- og gyldighedskontroller. Antag ikke, at dette ældre opslag implementerer disse kontroller eller accepterer alle identifikatorer, som portalen accepterer.
Tomme svar og fejl
Hvis ingen gemt række matcher, udsender den nuværende handler intet JSON-resultat og intet eksplicit ikke fundet-svar. En tom body er ikke en pris på nul, en tilgængelig plan eller et bekræftet vellykket opslag. Kontroller både HTTP-svaret og JSON-strukturen; bestil ikke ud fra manglende eller uparsebare prisdata.
Autentificering, kilde-IP-begrænsninger og databasefejl kan også forhindre et brugbart svar. Der findes ingen handler-specifik fejlkonvolut for en databaseundtagelse. Opdater dit valg, eller kontakt support, når et autentificeret opslag forbliver utilgængeligt.
Virkninger og begrænsninger
Det gennemgåede opslag udfører en læseforespørgsel og indeholder ingen debitering, intet køb, ingen reservation og ingen opdatering af leverandørpriser. Læsning af gemte priser fastslår ikke aktuel beholdning, myndighedsgodkendelse, kontoens købstilladelse eller endelig fakturering.