Lees 'n gestoorde prysplan
Nadat jy beskikbare telefoonnommers deurgeblaai het, soek die prysrye op wat vir jou API-rekening gestoor is. Gebruik die prysopsie se uuid uit die gekose nommer se price-lys, nie sy nommer, voorvoegsel-ID of area-ID nie. Hou die gekose nommer en prysopsie bymekaar.
Dit is 'n versoenbaarheidsopsoek van gestoorde pryse. Dit verfris nie beskikbaarheid of pryse nie, reserveer nie 'n nommer nie, plaas nie 'n bestelling nie, en waarborg nie die bedrag van 'n toekomstige aankoop nie. Hersien die prysopsie wat met 'n vars nommersoektog teruggestuur word voordat jy bestel.
Versoek
Gebruik jou geaktiveerde API-rekening oor HTTPS vanaf 'n toegelate IP-adres. Stel PRICE_ID op die presiese prysopsie-ID wat jy ontvang het. Die metode lees een padargument en geen liggaam-, datum- of bladsyparameters nie.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Dieselfde rekening wat die prysopsie verkry het, moet hierdie opsoek doen. Moenie 'n ID saamstel, 'n databasisrynommer gebruik of 'n ander rekening se keuse vervang nie. Die verouderde metode pas slegs die sigbare prys-ID.
Antwoord
Die volgende fiktiewe voorbeeld wys slegs geselekteerde kliëntgerigte velde. Werklike antwoorde stuur volledige gestoorde rye terug en kan bykomende rekening-, verskaffer- en interne prysmetadata insluit. Hou die volledige antwoord op jou bediener en stel slegs die kliëntgerigte waardes bloot wat jou toepassing nodig het.
{
"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 'n lys, selfs vir een ry. status.results tel die teruggestuurde rye. Numeriese databasiswaardes kan stringe wees. Die eindpunt voeg nie 'n geldeenheidveld by of skakel geldeenhede om nie; bevestig die rekening se faktureringsgeldeenheid eerder as om dit uit hierdie voorbeeld af te lei.
Prysvelde
| Veld | Betekenis |
|---|---|
| visible_uuid | Die gestoorde prysopsie se sigbare identifiseerder. Gebruik die oorspronklike opsie-ID wanneer jy die opsoek korreleer. |
| setup_price | Gestoorde eenmalige opstelprys vir hierdie opsie. |
| monthly_price | Gestoorde herhalende maandelikse prys. |
| per_minute, free_minutes | Gestoorde minuuttarief vir inkomende oproepe en hoeveelheid ingeslote minute. Hierdie kwoteer nie uitgaande oproepe of elke moontlike bykomende heffing nie. |
| channels | Gestoorde kanaalhoeveelheid vir hierdie opsie; dit is nie 'n lewendige kapasiteits- of registrasiekontrole nie. |
| yearly_price | 'n Bykomende gestoorde jaarlikse prysveld kan teenwoordig wees. Moenie aflei dat 'n nie-nul maandelikse prys en 'n nul-jaarveld 'n gratis jaarplan verteenwoordig nie. |
Hanteer veelvuldige passende rye
'n Opsoek kan meer as een gestoorde ry terugstuur. Die metode bied geen gewaarborgde volgorde, keuse van die nuutste ry of nommer-/voorvoegselfilter nie. Moenie stilweg die eerste of laaste ry kies nie. Vergelyk die teruggestuurde konteks met die oorspronklike gekose nommer en prysopsie; as dit dubbelsinnig of verouderd bly, verfris die nommersoektog eerder as om hierdie antwoord as 'n bestellingskwotasie te hanteer.
Die portaal se bestellingshersieningswerkvloei voer bykomende keuse- en geldigheidskontroles uit. Moenie aanneem dat hierdie verouderde opsoek daardie kontroles implementeer of elke identifiseerder aanvaar wat die portaal aanvaar nie.
Leë antwoorde en foute
As geen gestoorde ry pas nie, lewer die huidige hanteerder geen JSON-resultaat en geen eksplisiete nie-gevind-antwoord nie. 'n Leë liggaam is nie 'n nulprys, 'n beskikbare plan of 'n bevestigde suksesvolle opsoek nie. Kontroleer beide die HTTP-antwoord en die JSON-struktuur; moenie bestel op grond van ontbrekende of onontleedbare prysdata nie.
Outentisering, bron-IP-beperkings en databasisfoute kan ook 'n bruikbare antwoord verhoed. Daar is geen hanteerderspesifieke foutomhulsel vir 'n databasisuitsondering nie. Verfris jou keuse of kontak ondersteuning wanneer 'n geoutentiseerde opsoek onbeskikbaar bly.
Effekte en beperkings
Die hersiene opsoek voer 'n leesnavraag uit en bevat geen debiet, aankoop, reservering of verfrissing van verskafferpryse nie. Die lees van gestoorde pryse bevestig nie huidige voorraad, regulatoriese goedkeuring, rekening-aankooptoestemming of finale fakturering nie.