Salvestatud hinnaplaani lugemine
Pärast saadaolevate telefoninumbrite sirvimist otsige teie API konto jaoks salvestatud hinnaridu. Kasutage hinnavaliku uuid valitud numbri price loendist, mitte selle numbrit, prefiksi ID-d ega piirkonna ID-d. Hoidke valitud number ja hinnavalik koos.
See on salvestatud hinnateabe ühilduvuspäring. See ei värskenda saadavust ega hindu, ei broneeri numbrit, ei esita tellimust ega taga tulevase ostu summat. Vaadake enne tellimist üle hinnavalik, mille tagastab värske numbriotsing.
Päring
Kasutage oma lubatud API kontot HTTPS-i kaudu lubatud IP-aadressilt. Määrake PRICE_ID väärtuseks täpselt see hinnavaliku ID, mille saite. Meetod loeb ühe tee argumendi ega kasuta keha-, kuupäeva- ega lehekülgedeks jaotamise parameetreid.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Selle päringu peab tegema sama konto, mis hinnavaliku sai. Ärge konstrueerige ID-d, ärge kasutage andmebaasi rea numbrit ega asendage seda teise konto valikuga. Pärandmeetod sobitab ainult nähtava hinna ID.
Vastus
Järgnev väljamõeldud näide näitab ainult valitud kliendile suunatud välju. Tegelikud vastused tagastavad täielikud salvestatud read ja võivad sisaldada täiendavaid konto, tarnija ja sisemise hinnakujunduse metaandmeid. Hoidke täielik vastus oma serveris ja avaldage ainult need kliendile suunatud väärtused, mida teie rakendus vajab.
{
"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 on loend, isegi ühe rea puhul. status.results loendab tagastatud ridu. Andmebaasi arvväärtused võivad olla stringid. Lõpp-punkt ei lisa valuutavälja ega konverteeri valuutasid; kinnitage konto arveldusvaluuta, selle asemel et seda sellest näitest tuletada.
Hinnaväljad
| Väli | Tähendus |
|---|---|
| visible_uuid | Salvestatud hinnavaliku nähtav identifikaator. Kasutage päringu seostamisel algset valiku ID-d. |
| setup_price | Selle valiku salvestatud ühekordne seadistustasu. |
| monthly_price | Salvestatud korduv kuuhind. |
| per_minute, free_minutes | Salvestatud sissetulevate kõnede minutihind ja sisalduvate minutite kogus. Need ei kajasta väljuvate kõnede hinda ega iga võimalikku lisatasu. |
| channels | Selle valiku salvestatud kanalite arv; see ei ole reaalajas mahu- ega registreerimiskontroll. |
| yearly_price | Olemas võib olla täiendav salvestatud aastahinna väli. Ärge järeldage, et nullist erinev kuuhind ja nulliga aastaväli tähendavad tasuta aastaplaani. |
Mitme sobiva rea käsitlemine
Päring võib tagastada rohkem kui ühe salvestatud rea. Meetod ei paku garanteeritud järjestust, uusima rea valikut ega numbri/prefiksi filtrit. Ärge valige vaikimisi esimest ega viimast rida. Võrrelge tagastatud konteksti algse valitud numbri ja hinnavalikuga; kui see jääb mitmetähenduslikuks või aegunuks, värskendage numbriotsingut, selle asemel et käsitleda seda vastust tellimuse hinnapakkumisena.
Portaali tellimuse ülevaatuse töövoog teeb täiendavaid valiku- ja kehtivuskontrolle. Ärge eeldage, et see pärandpäring rakendab neid kontrolle või aktsepteerib iga identifikaatorit, mida portaal aktsepteerib.
Tühjad vastused ja vead
Kui ükski salvestatud rida ei sobi, ei väljasta praegune käsitleja JSON-tulemust ega selgesõnalist mitteleidmise vastust. Tühi keha ei tähenda nullhinda, saadaolevat plaani ega kinnitatud edukat päringut. Kontrollige nii HTTP vastust kui ka JSON-struktuuri; ärge tellige puuduvate või parsimatute hinnaandmete põhjal.
Kasutatava vastuse võivad takistada ka autentimine, lähte-IP piirangud ja andmebaasi tõrked. Andmebaasi erandi jaoks puudub käsitlejapõhine veaümbris. Värskendage oma valikut või võtke ühendust toega, kui autenditud päring jääb kättesaamatuks.
Mõjud ja piirangud
Ülevaadatud päring teeb lugemispäringu ega sisalda debiteerimist, ostu, broneeringut ega teenusepakkuja hinna värskendamist. Salvestatud hinnateabe lugemine ei tõenda praegust laoseisu, regulatiivset heakskiitu, konto ostuluba ega lõplikku arveldust.