Nolasīt saglabātu cenu plānu
Pēc pieejamo tālruņa numuru pārlūkošanas meklējiet cenu rindas, kas saglabātas jūsu API kontam. Izmantojiet cenas opcijas uuid no izvēlētā numura price saraksta, nevis tā numuru, prefiksa ID vai apgabala ID. Turiet izvēlēto numuru un cenas opciju kopā.
Šī ir saglabāto cenu saderības meklēšana. Tā neatjauno pieejamību vai cenas, nerezervē numuru, neveic pasūtījumu un negarantē nākotnes pirkuma summu. Pirms pasūtīšanas pārskatiet cenas opciju, kas atgriezta ar jaunu numuru meklēšanu.
Pieprasījums
Izmantojiet savu iespējoto API kontu, izmantojot HTTPS no atļautas IP adreses. Iestatiet PRICE_ID uz precīzo saņemto cenas opcijas ID. Metode nolasa vienu ceļa argumentu un nekādus pamatteksta, datuma vai lappušu dalīšanas parametrus.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Šī meklēšana jāveic tam pašam kontam, kurš ieguva cenas opciju. Nekonstruējiet ID, neizmantojiet datubāzes rindas numuru un neaizstājiet to ar cita konta izvēli. Mantotā metode salīdzina tikai redzamo cenas ID.
Atbilde
Šajā izdomātajā piemērā parādīti tikai atlasīti klientam redzamie lauki. Faktiskās atbildes atgriež pilnas saglabātās rindas un var ietvert papildu konta, piegādātāja un iekšējo cenu metadatus. Glabājiet pilno atbildi savā serverī un atklājiet tikai tās klientam redzamās vērtības, kas nepieciešamas jūsu lietojumprogrammai.
{
"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 ir saraksts pat vienai rindai. status.results uzskaita atgrieztās rindas. Datubāzes skaitliskās vērtības var būt virknes. Galapunkts nepievieno valūtas lauku un nekonvertē valūtas; apstipriniet konta norēķinu valūtu, nevis seciniet to no šī piemēra.
Cenu lauki
| Lauks | Nozīme |
|---|---|
| visible_uuid | Saglabātās cenas opcijas redzamais identifikators. Korelējot meklēšanu, izmantojiet sākotnējo opcijas ID. |
| setup_price | Saglabātā vienreizējā iestatīšanas cena šai opcijai. |
| monthly_price | Saglabātā regulārā mēneša cena. |
| per_minute, free_minutes | Saglabātā ienākošo zvanu minūtes likme un iekļauto minūšu daudzums. Tie nenosaka cenu izejošajiem zvaniem vai katrai iespējamai piemaksai. |
| channels | Saglabātais kanālu daudzums šai opcijai; tā nav reāllaika ietilpības vai reģistrācijas pārbaude. |
| yearly_price | Var būt papildu saglabāts gada cenas lauks. Nepieņemiet, ka mēneša cena, kas nav nulle, un nulles vērtība gada laukā nozīmē bezmaksas gada plānu. |
Vairāku atbilstošu rindu apstrāde
Meklēšana var atgriezt vairāk nekā vienu saglabātu rindu. Metode nenodrošina garantētu kārtošanu, jaunākās rindas atlasi vai numura/prefiksa filtru. Klusējot neizvēlieties pirmo vai pēdējo rindu. Salīdziniet atgriezto kontekstu ar sākotnēji izvēlēto numuru un cenas opciju; ja tas joprojām ir neviennozīmīgs vai novecojis, atjaunojiet numuru meklēšanu, nevis uztveriet šo atbildi kā pasūtījuma cenas piedāvājumu.
Portāla pasūtījuma pārskatīšanas darbplūsma veic papildu atlases un derīguma pārbaudes. Nepieņemiet, ka šī mantotā meklēšana īsteno šīs pārbaudes vai pieņem katru identifikatoru, ko pieņem portāls.
Tukšas atbildes un kļūdas
Ja neviena saglabātā rinda neatbilst, pašreizējais apstrādātājs neizvada ne JSON rezultātu, ne skaidru atbildi par neatrašanu. Tukšs pamatteksts nav nulles cena, pieejams plāns vai apstiprināta veiksmīga meklēšana. Pārbaudiet gan HTTP atbildi, gan JSON struktūru; neveiciet pasūtījumu, balstoties uz trūkstošiem vai neparsējamiem cenu datiem.
Autentifikācija, avota IP ierobežojumi un datubāzes kļūmes arī var neļaut saņemt izmantojamu atbildi. Datubāzes izņēmumam nav apstrādātājam specifiskas kļūdas aploksnes. Atjaunojiet savu izvēli vai sazinieties ar atbalsta dienestu, ja autentificēta meklēšana joprojām nav pieejama.
Ietekme un ierobežojumi
Pārskatītā meklēšana veic lasīšanas vaicājumu un neietver debetēšanu, pirkumu, rezervēšanu vai piegādātāja cenu atjaunošanu. Saglabāto cenu nolasīšana nenosaka pašreizējos krājumus, regulatīvo apstiprinājumu, konta pirkuma atļauju vai galīgos norēķinus.