Čitanje spremljenog cjenovnog plana
Nakon pregledavanja dostupnih telefonskih brojeva pretražite retke cijena spremljene za vaš API račun. Upotrijebite vrijednost uuid cjenovne opcije s popisa price odabranog broja, a ne njegov broj, ID prefiksa ili ID područja. Odabrani broj i cjenovnu opciju držite zajedno.
Ovo je pretraživanje spremljenih cijena radi kompatibilnosti. Ne osvježava dostupnost ni cijene, ne rezervira broj, ne kreira narudžbu niti jamči iznos buduće kupnje. Prije naručivanja pregledajte cjenovnu opciju vraćenu svježim pretraživanjem brojeva.
Zahtjev
Upotrijebite svoj omogućeni API račun putem HTTPS-a s dopuštene IP adrese. Postavite PRICE_ID na točan ID cjenovne opcije koji ste primili. Metoda čita jedan argument putanje i nema parametara tijela, datuma ni straničenja.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Ovo pretraživanje mora izvršiti isti račun koji je dobio cjenovnu opciju. Nemojte sami sastavljati ID, upotrebljavati broj retka baze podataka ni zamjenjivati ga odabirom drugog računa. Naslijeđena metoda podudara samo vidljivi ID cijene.
Odgovor
Sljedeći izmišljeni primjer prikazuje samo odabrana polja namijenjena korisnicima. Stvarni odgovori vraćaju potpune spremljene retke i mogu uključivati dodatne metapodatke o računu, dobavljaču i internim cijenama. Zadržite potpuni odgovor na svojem poslužitelju i izložite samo vrijednosti namijenjene korisnicima koje vaša aplikacija treba.
{
"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 popis, čak i za jedan redak. status.results broji vraćene retke. Numeričke vrijednosti iz baze podataka mogu biti nizovi znakova. Krajnja točka ne dodaje polje valute niti pretvara valute; potvrdite valutu naplate računa umjesto da je izvodite iz ovog primjera.
Polja cijene
| Polje | Značenje |
|---|---|
| visible_uuid | Vidljivi identifikator spremljene cjenovne opcije. Pri povezivanju pretraživanja upotrijebite izvorni ID opcije. |
| setup_price | Pohranjena jednokratna cijena postavljanja za ovu opciju. |
| monthly_price | Pohranjena ponavljajuća mjesečna cijena. |
| per_minute, free_minutes | Pohranjena cijena minute dolaznih poziva i količina uključenih minuta. Ne daju ponudu za odlazne pozive ni za svaku moguću dodatnu naknadu. |
| channels | Pohranjena količina kanala za ovu opciju; to nije provjera kapaciteta ni registracije u stvarnom vremenu. |
| yearly_price | Može biti prisutno i dodatno pohranjeno polje godišnje cijene. Nemojte zaključivati da mjesečna cijena različita od nule i godišnje polje s vrijednošću nula predstavljaju besplatan godišnji plan. |
Obrada više podudarnih redaka
Pretraživanje može vratiti više od jednog spremljenog retka. Metoda ne jamči redoslijed, odabir najnovijeg retka ni filtar po broju/prefiksu. Nemojte prešutno odabrati prvi ili posljednji redak. Usporedite vraćeni kontekst s izvorno odabranim brojem i cjenovnom opcijom; ako i dalje ostaje dvosmislen ili zastario, osvježite pretraživanje brojeva umjesto da ovaj odgovor tretirate kao ponudu za narudžbu.
Tijek rada pregleda narudžbe na portalu provodi dodatne provjere odabira i valjanosti. Nemojte pretpostavljati da ovo naslijeđeno pretraživanje provodi te provjere ili da prihvaća svaki identifikator koji portal prihvaća.
Prazni odgovori i pogreške
Ako se nijedan spremljeni redak ne podudara, trenutačni rukovatelj ne emitira JSON rezultat ni izričit odgovor da ništa nije pronađeno. Prazno tijelo nije cijena nula, dostupan plan ni potvrđeno uspješno pretraživanje. Provjerite i HTTP odgovor i JSON strukturu; nemojte naručivati na temelju nedostajućih ili neraščlanjivih podataka o cijeni.
Autentifikacija, ograničenja izvorne IP adrese i kvarovi baze podataka također mogu spriječiti upotrebljiv odgovor. Za iznimku baze podataka ne postoji omotnica pogreške specifična za rukovatelja. Osvježite svoj odabir ili se obratite podršci kada autentificirano pretraživanje i dalje nije dostupno.
Učinci i ograničenja
Pregledano pretraživanje izvršava upit za čitanje i ne sadrži terećenje, kupnju, rezervaciju ni osvježavanje cijena pružatelja. Čitanje spremljenih cijena ne utvrđuje trenutačne zalihe, regulatorno odobrenje, dopuštenje računa za kupnju ni konačnu naplatu.