Dohvatite stanje, valutu i vrijednost uvjeta plaćanja za račun kojem pripadaju vaše API vjerodajnice. Ovo je provjera stanja; njome se ne dodaju sredstva niti se šalje narudžba.
Zahtjev
Upotrebljavajte API vjerodajnice na poslužiteljskoj strani putem HTTPS-a. Primjeri čitaju vjerodajnice iz varijabli okruženja; ne sadrže vjerodajnice koje se mogu upotrijebiti za pristup. Provjerite status.code u tijelu JSON odgovora, kao i HTTP status. Ovi naslijeđeni obrađivači ne postavljaju dosljedno HTTP status pogreške kada dođe do pogreške u aplikaciji.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Nisu potrebni parametri putanje, upita ni tijela zahtjeva.
Odgovor
Ovo je ilustrativni prikaz strukture odgovora, a ne podaci računa ili aktualna cjenovna ponuda.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Polje | Značenje |
|---|---|
balance | Pohranjeno stanje računa. Pri obradi novčanih vrijednosti očuvajte decimalnu preciznost. |
currency | Vrijednost valute pohranjena za ovaj račun. |
terms | Pohranjena vrijednost uvjeta plaćanja za račun. Obrađivač ne navodi popis mogućih vrijednosti niti normalizira tu vrijednost; nemojte pretpostaviti da primjer obuhvaća sve moguće vrijednosti. |
Pogreške i upotreba
U slučaju neuspjele autentifikacije upotrebljava se zajednički odgovor API-ja za autentifikaciju. Ovaj obrađivač ne definira zasebnu pogrešku za nedostajuće stanje računa ni straničenje. Vraćeno stanje ne predstavlja rezervaciju sredstava i ne jamči da će naknadna narudžba uspjeti.