Програмери

GET/v3/getbalance

Очитавање стања рачуна

Очитајте сачувано стање, валуту и услове плаћања за свој API налог.

На овој страници
  1. Захтев
  2. Одговор
  3. Грешке и употреба

Очитајте стање, валуту и вредност услова плаћања за налог на који се односе ваши API акредитиви. Ово је провера стања; њоме се не додају средства нити се креира поруџбина.

Захтев

Користите API акредитиве на серверској страни преко HTTPS-а. Примери читају акредитиве из променљивих окружења; не садрже акредитиве који се могу употребити за приступ. Проверите status.code у телу JSON одговора, као и HTTP статус. Ови старији обрађивачи не постављају доследно HTTP статус грешке када дође до грешке у апликацији.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/getbalance"

Нису потребни параметри путање, упита нити тела захтева.

Одговор

Ово је илустрација структуре одговора, а не подаци о налогу или понуда са актуелним ценама.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "125.50",
    "currency": "USD",
    "terms": "prepaid"
  }
}
Поља одговора о стању рачуна
ПољеЗначење
balanceСачувано стање рачуна. При обради новчаних вредности очувајте децималну прецизност.
currencyВредност валуте сачувана за овај налог.
termsСачувана вредност услова плаћања за налог. Обрађивач не наводи све могуће вредности нити нормализује ову вредност; немојте претпоставити да пример обухвата све могуће вредности.

Грешке и употреба

При неуспешној аутентификацији користи се заједнички API одговор за аутентификацију. Овај обрађивач не дефинише посебну грешку за случај када стање недостаје нити пагинацију. Враћено стање не представља резервацију средстава и не гарантује да ће каснија поруџбина бити успешна.