Lexoni një plan çmimi të ruajtur
Kërkoni rreshtat e çmimeve të ruajtura për llogarinë tuaj API pasi të keni shfletuar numrat e telefonit të disponueshëm. Përdorni uuid e opsionit të çmimit nga lista price e numrit të zgjedhur, jo numrin e tij, ID-në e prefiksit ose ID-në e zonës. Mbani së bashku numrin e zgjedhur dhe opsionin e çmimit.
Ky është një kërkim pajtueshmërie i çmimeve të ruajtura. Ai nuk rifreskon disponueshmërinë ose çmimet, nuk rezervon një numër, nuk bën një porosi dhe nuk garanton shumën e një blerjeje të ardhshme. Shqyrtoni opsionin e çmimit të kthyer nga një kërkim i ri numrash përpara se të porositni.
Kërkesa
Përdorni llogarinë tuaj API të aktivizuar përmes HTTPS nga një adresë IP e lejuar. Vendosni PRICE_ID në ID-në e saktë të opsionit të çmimit që keni marrë. Metoda lexon një argument të vetëm në shteg dhe asnjë parametër trupi, date ose faqosjeje.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Këtë kërkim duhet ta bëjë e njëjta llogari që ka marrë opsionin e çmimit. Mos ndërtoni një ID, mos përdorni një numër rreshti të bazës së të dhënave dhe mos e zëvendësoni me zgjedhjen e një llogarie tjetër. Metoda e trashëguar përputh vetëm ID-në e dukshme të çmimit.
Përgjigja
Shembulli fiktiv i mëposhtëm tregon vetëm disa fusha të zgjedhura të destinuara për klientin. Përgjigjet reale kthejnë rreshta të plotë të ruajtur dhe mund të përfshijnë metadata shtesë të llogarisë, të furnitorit dhe të çmimeve të brendshme. Mbajeni përgjigjen e plotë në serverin tuaj dhe ekspozoni vetëm vlerat e destinuara për klientin që i nevojiten aplikacionit tuaj.
{
"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 është një listë, edhe për një rresht të vetëm. status.results numëron rreshtat e kthyer. Vlerat numerike të bazës së të dhënave mund të jenë vargje. Pika fundore nuk shton një fushë monedhe dhe nuk konverton monedha; konfirmoni monedhën e faturimit të llogarisë në vend që ta nxirrni atë nga ky shembull.
Fushat e çmimit
| Fusha | Kuptimi |
|---|---|
| visible_uuid | Identifikuesi i dukshëm i opsionit të çmimit të ruajtur. Përdorni ID-në origjinale të opsionit kur e lidhni kërkimin me zgjedhjen. |
| setup_price | Çmimi i ruajtur i konfigurimit, i njëhershëm, për këtë opsion. |
| monthly_price | Çmimi mujor i përsëritur i ruajtur. |
| per_minute, free_minutes | Tarifa e ruajtur për minutë e thirrjeve hyrëse dhe sasia e minutave të përfshira. Këto nuk japin çmime për thirrjet dalëse dhe as për çdo tarifë shtesë të mundshme. |
| channels | Sasia e ruajtur e kanaleve për këtë opsion; nuk është një kontroll i drejtpërdrejtë i kapacitetit ose i regjistrimit. |
| yearly_price | Mund të jetë e pranishme një fushë shtesë e ruajtur e çmimit vjetor. Mos nxirrni përfundimin se një çmim mujor jo zero dhe një fushë vjetore me vlerë zero përfaqësojnë një plan vjetor falas. |
Trajtoni rreshta të shumëfishtë që përputhen
Një kërkim mund të kthejë më shumë se një rresht të ruajtur. Metoda nuk ofron renditje të garantuar, zgjedhje të rreshtit më të fundit apo filtër sipas numrit/prefiksit. Mos zgjidhni në heshtje rreshtin e parë ose të fundit. Krahasoni kontekstin e kthyer me numrin dhe opsionin e çmimit të zgjedhur fillimisht; nëse mbetet i paqartë ose i vjetruar, rifreskoni kërkimin e numrave në vend që ta trajtoni këtë përgjigje si një ofertë porosie.
Rrjedha e punës për shqyrtimin e porosive në portal kryen kontrolle shtesë të zgjedhjes dhe të vlefshmërisë. Mos supozoni se ky kërkim i trashëguar i zbaton ato kontrolle ose se pranon çdo identifikues që pranon portali.
Përgjigjet boshe dhe gabimet
Nëse asnjë rresht i ruajtur nuk përputhet, trajtuesi aktual nuk nxjerr asnjë rezultat JSON dhe asnjë përgjigje të qartë të tipit nuk-u-gjet. Një trup bosh nuk është një çmim zero, një plan i disponueshëm apo një kërkim i suksesshëm i konfirmuar. Kontrolloni si përgjigjen HTTP ashtu edhe strukturën JSON; mos porositni nga të dhëna çmimi që mungojnë ose që nuk mund të analizohen.
Autentikimi, kufizimet e IP-së burimore dhe dështimet e bazës së të dhënave gjithashtu mund të pengojnë një përgjigje të përdorshme. Nuk ka një mbështjellës gabimi specifik për trajtuesin në rast të një përjashtimi të bazës së të dhënave. Rifreskoni zgjedhjen tuaj ose kontaktoni mbështetjen kur një kërkim i autentikuar mbetet i padisponueshëm.
Efektet dhe kufizimet
Kërkimi i shqyrtuar kryen një pyetje leximi dhe nuk përmban asnjë debitim, blerje, rezervim apo rifreskim të çmimeve të ofruesit. Leximi i çmimeve të ruajtura nuk përcakton inventarin aktual, miratimin rregullator, lejen e blerjes për llogarinë apo faturimin përfundimtar.