# Запрос проверки баланса

## Запрос проверки баланса

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/json/balance.php`

#### Headers

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/json; charset=utf-8`** |

#### Request Body

| Name                                       | Type   | Description                                                                                         |
| ------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------- |
| login<mark style="color:red;">\*</mark>    | String | Ваш логин в системе                                                                                 |
| token<mark style="color:red;">\*</mark>    | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру. |
| password<mark style="color:red;">\*</mark> | String | Ваш пароль в системе                                                                                |

{% tabs %}
{% tab title="200: OK В случае получения правильного JSON-документа" %}

```json
{
    "money": "19023.9",
    "currency": "RUR",
    "information": 
        [
            {
                "type_sms": "sms",
                "area": "Tele2",
                "num_sms": "72029"
            }, 
            {
                "type_sms": "sms",
                "area": "Россия",
                "num_sms": "Безлимит"
            }
        ]
}
```

{% endtab %}

{% tab title="400: Bad Request В случае возникновения ошибки в отправленном JSON-документе" %}

```json
{
    "error": "Текст ошибки."
}
```

{% endtab %}
{% endtabs %}

### Расшифровка параметров в ответах на запрос

<table><thead><tr><th width="210.33333333333331">Параметр</th><th width="137">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>money</td><td>Int</td><td>Остаток средств</td></tr><tr><td>currency</td><td>String</td><td>Валюта</td></tr><tr><td>information.type_sms</td><td>String</td><td>Тип SMS</td></tr><tr><td>information.area</td><td>String</td><td>Направление, в котором может быть отправлено данное количество SMS</td></tr><tr><td>information.sms</td><td>Int</td><td>Количество доступных SMSсообщений для данного направления</td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат JSON документа </li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul></td></tr></tbody></table>