Čitanje sačuvanog cenovnog plana
Potražite redove cena sačuvane za vaš API nalog nakon pregledanja dostupnih telefonskih brojeva. Koristite uuid cenovne opcije iz liste price izabranog broja, a ne njegov broj, ID prefiksa ili ID oblasti. Držite izabrani broj i cenovnu opciju zajedno.
Ovo je pretraživanje sačuvanih cena radi kompatibilnosti. Ono ne osvežava dostupnost ni cene, ne rezerviše broj, ne kreira porudžbinu niti garantuje iznos buduće kupovine. Pre poručivanja proverite cenovnu opciju vraćenu u novoj pretrazi brojeva.
Zahtev
Koristite svoj omogućeni API nalog preko HTTPS-a sa dozvoljene IP adrese. Postavite PRICE_ID na tačan ID cenovne opcije koji ste primili. Metoda čita jedan argument putanje i nema parametre tela, datuma ni paginacije.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Isti nalog koji je dobio cenovnu opciju mora da izvrši ovo pretraživanje. Nemojte konstruisati ID, koristiti broj reda iz baze podataka niti zamenjivati izbor drugog naloga. Nasleđena metoda poklapa samo vidljivi ID cene.
Odgovor
Sledeći izmišljeni primer prikazuje samo odabrana polja namenjena korisnicima. Stvarni odgovori vraćaju kompletne sačuvane redove i mogu uključivati dodatne metapodatke o nalogu, dobavljaču i internim cenama. Čuvajte pun odgovor na svom serveru i izložite samo vrednosti namenjene korisnicima koje su vašoj aplikaciji potrebne.
{
"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 je lista, čak i za jedan red. status.results broji vraćene redove. Numeričke vrednosti iz baze podataka mogu biti stringovi. Krajnja tačka ne dodaje polje valute niti konvertuje valute; potvrdite valutu naplate naloga umesto da je izvodite iz ovog primera.
Polja cene
| Polje | Značenje |
|---|---|
| visible_uuid | Vidljivi identifikator sačuvane cenovne opcije. Koristite originalni ID opcije prilikom povezivanja pretraživanja. |
| setup_price | Sačuvana jednokratna cena podešavanja za ovu opciju. |
| monthly_price | Sačuvana periodična mesečna cena. |
| per_minute, free_minutes | Sačuvana minutna tarifa dolaznih poziva i količina uključenih minuta. One ne daju cenu odlaznih poziva niti svake moguće doplate. |
| channels | Sačuvana količina kanala za ovu opciju; to nije provera trenutnog kapaciteta ni registracije. |
| yearly_price | Može biti prisutno i dodatno sačuvano polje godišnje cene. Nemojte zaključivati da mesečna cena različita od nule i godišnje polje jednako nuli predstavljaju besplatan godišnji plan. |
Obrada više podudarnih redova
Pretraživanje može vratiti više od jednog sačuvanog reda. Metoda ne obezbeđuje zagarantovan redosled, izbor najnovijeg reda ni filter po broju/prefiksu. Nemojte prećutno birati prvi ili poslednji red. Uporedite vraćeni kontekst sa prvobitno izabranim brojem i cenovnom opcijom; ako ostane dvosmislen ili zastareo, osvežite pretragu brojeva umesto da ovaj odgovor tretirate kao ponudu za porudžbinu.
Tok pregleda porudžbine na portalu obavlja dodatne provere izbora i važenja. Nemojte pretpostavljati da ovo nasleđeno pretraživanje sprovodi te provere ili prihvata svaki identifikator koji portal prihvata.
Prazni odgovori i greške
Ako se nijedan sačuvani red ne podudara, trenutni obrađivač ne emituje JSON rezultat niti eksplicitan odgovor „nije pronađeno“. Prazno telo nije nulta cena, dostupan plan ni potvrđeno uspešno pretraživanje. Proverite i HTTP odgovor i JSON strukturu; nemojte poručivati na osnovu nedostajućih ili neraščlanjivih podataka o ceni.
Autentifikacija, ograničenja izvorne IP adrese i otkazi baze podataka takođe mogu sprečiti upotrebljiv odgovor. Ne postoji omotač greške specifičan za obrađivač u slučaju izuzetka baze podataka. Osvežite svoj izbor ili kontaktirajte podršku kada autentifikovano pretraživanje ostane nedostupno.
Efekti i ograničenja
Pregledano pretraživanje izvršava upit za čitanje i ne sadrži zaduženje, kupovinu, rezervaciju ni osvežavanje cena dobavljača. Čitanje sačuvanih cena ne utvrđuje trenutni inventar, regulatorno odobrenje, dozvolu naloga za kupovinu ni konačnu naplatu.