Извлечете салдото, валутата и стойността за условията на плащане на акаунта, идентифициран чрез вашите идентификационни данни за 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 за удостоверяване. Този обработчик не дефинира отделна грешка за липсващо салдо, нито страниране. Върнатото салдо не представлява резервиране на средства и не гарантира, че последваща поръчка ще бъде успешна.