Проверка состояния баланса
Для запроса баланса используйте адрес:
https://cp.smsteam.ru/sys/balance.php?login=<login>&psw=<password>
Серверу передаются следующие параметры:
Параметр | Значение |
---|---|
login | Логин Клиента. |
psw | Пароль Клиента или MD5-хеш пароля в нижнем регистре. |
fmt | Формат ответа сервера: 0 или 1 – (по умолчанию) в виде строки (250.80). 2 – в xml формате. 3 – в json формате. |
В случае ошибки Сервер возвращает следующую строку:
- При fmt = 0: ERROR = N (описание)
- При fmt = 1: 0,-N
- При fmt = 2:
<result>
<error>описание</error>
<error_code>N</error_code>
</result> - При fmt = 3:
{
«error»: «описание»,
«error_code»: N
}
N – номер ошибки, может принимать следующие значения:
Значение | Описание |
---|---|
1 | Ошибка в параметрах. |
2 | Неверный логин или пароль. |
В случае успешного запроса Сервер возвращает ответ в виде строки:
- при fmt = 0 или 1: <balance>
- при fmt = 2: <balance>balance</balance>
- при fmt = 3:
{
«balance»: «<balance>»
}
Где <balance> – текущее состояние баланса в рублях.
Сервер не принимает более десяти запросов на получение баланса в течение минуты для снижения
нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.