Nuskaityti išsaugotą kainų planą
Ieškokite kainų eilučių, išsaugotų jūsų API paskyrai peržiūrėjus galimus telefono numerius. Naudokite kainos parinkties uuid iš pasirinkto numerio price sąrašo, o ne jo numerį, prefikso ID ar zonos ID. Laikykite pasirinktą numerį ir kainos parinktį kartu.
Tai suderinamumo tikslais skirta išsaugotų kainų paieška. Ji neatnaujina prieinamumo ar kainų, nerezervuoja numerio, nepateikia užsakymo ir negarantuoja būsimo pirkimo sumos. Prieš užsakydami peržiūrėkite kainos parinktį, grąžintą atlikus naują numerių paiešką.
Užklausa
Naudokite savo įjungtą API paskyrą per HTTPS iš leidžiamo IP adreso. Nustatykite PRICE_ID į tikslų gautą kainos parinkties ID. Metodas nuskaito vieną kelio argumentą ir jokių užklausos turinio, datos ar puslapiavimo parametrų.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Šią paiešką turi atlikti ta pati paskyra, kuri gavo kainos parinktį. Nekonstruokite ID, nenaudokite duomenų bazės eilutės numerio ir nepakeiskite jo kitos paskyros pasirinkimu. Senasis metodas sutapdina tik matomą kainos ID.
Atsakymas
Toliau pateiktame išgalvotame pavyzdyje rodomi tik pasirinkti klientams skirti laukai. Tikri atsakymai grąžina visas išsaugotas eilutes ir gali apimti papildomus paskyros, tiekėjo ir vidinių kainų metaduomenis. Laikykite visą atsakymą savo serveryje ir atskleiskite tik tas klientams skirtas reikšmes, kurių reikia jūsų programai.
{
"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 yra sąrašas, net jei grąžinama viena eilutė. status.results nurodo grąžintų eilučių skaičių. Duomenų bazės skaitinės reikšmės gali būti pateikiamos kaip simbolių eilutės. Galinis taškas neprideda valiutos lauko ir nekonvertuoja valiutų; patvirtinkite paskyros atsiskaitymo valiutą, o ne spėkite ją pagal šį pavyzdį.
Kainos laukai
| Laukas | Reikšmė |
|---|---|
| visible_uuid | Išsaugotos kainos parinkties matomas identifikatorius. Susiedami paiešką naudokite pradinį parinkties ID. |
| setup_price | Išsaugota vienkartinė šios parinkties sąrankos kaina. |
| monthly_price | Išsaugota periodinė mėnesinė kaina. |
| per_minute, free_minutes | Išsaugotas įeinančių skambučių minutės tarifas ir įskaičiuotų minučių kiekis. Jie nenurodo išeinančių skambučių kainos ar visų galimų papildomų mokesčių. |
| channels | Išsaugotas šios parinkties kanalų kiekis; tai nėra realaus laiko talpos ar registracijos patikra. |
| yearly_price | Gali būti pateiktas papildomas išsaugotos metinės kainos laukas. Nedarykite išvados, kad nenulinė mėnesinė kaina ir nulinis metinės kainos laukas reiškia nemokamą metinį planą. |
Kelių atitinkančių eilučių apdorojimas
Paieška gali grąžinti daugiau nei vieną išsaugotą eilutę. Metodas negarantuoja rikiavimo tvarkos, naujausios eilutės parinkimo ar filtravimo pagal numerį arba prefiksą. Tyliai nepasirinkite pirmos ar paskutinės eilutės. Palyginkite grąžintą kontekstą su iš pradžių pasirinktu numeriu ir kainos parinktimi; jei jis lieka neaiškus arba pasenęs, atnaujinkite numerių paiešką, užuot laikę šį atsakymą užsakymo kainos pasiūlymu.
Portalo užsakymo peržiūros procesas atlieka papildomas parinkimo ir galiojimo patikras. Nemanykite, kad ši senoji paieška įgyvendina tas patikras arba priima kiekvieną identifikatorių, kurį priima portalas.
Tušti atsakymai ir klaidos
Jei nė viena išsaugota eilutė neatitinka, dabartinė apdorojimo logika nepateikia nei JSON rezultato, nei aiškaus „nerasta“ atsakymo. Tuščias turinys nereiškia nulinės kainos, prieinamo plano ar patvirtintos sėkmingos paieškos. Patikrinkite ir HTTP atsakymą, ir JSON struktūrą; neužsakykite remdamiesi trūkstamais ar neišanalizuojamais kainų duomenimis.
Tinkamą atsakymą gauti taip pat gali sutrukdyti autentifikavimas, šaltinio IP apribojimai ir duomenų bazės triktys. Duomenų bazės išimčiai nėra specialaus šiai apdorojimo logikai skirto klaidos vokelio. Jei autentifikuota paieška išlieka neprieinama, atnaujinkite savo pasirinkimą arba kreipkitės į palaikymo tarnybą.
Poveikis ir apribojimai
Peržiūrėta paieška vykdo skaitymo užklausą ir neapima jokio nurašymo, pirkimo, rezervavimo ar tiekėjo kainų atnaujinimo. Išsaugotų kainų nuskaitymas nenustato dabartinių atsargų, reguliavimo institucijų patvirtinimo, paskyros teisės pirkti ar galutinio atsiskaitymo.