# POST запрос

## Запрос статуса SMS

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/json/state.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 | Ваш логин в системе                                                                                 |
| password<mark style="color:red;">\*</mark> | String | Ваш пароль в системе                                                                                |
| token<mark style="color:red;">\*</mark>    | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру. |
| id\_sms<mark style="color:red;">\*</mark>  | Int    | Номер SMS сообщения, полученный в ответном JSON-документа в процессе отправки SMS сообщения         |
| detail<mark style="color:red;">\*</mark>   | Int    | 0 или 1 в случае необходимости получения кол-во частей и цены за одну часть смс                     |

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

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

{% endtab %}

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

```json
[
    {
        "id_sms": 82216,
        "time_change_state": "2021-04-26 15:15:03",
        "state": "deliver",
        "num_parts": 1,
        "price": 10.6000000
    }
]

```

{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="178.33333333333331">Параметр</th><th width="133">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>id_sms</td><td>Int</td><td>Номер SMS сообщения, полученный в ответном JSON-документа в процессе отправки SMS сообщения</td></tr><tr><td>time_change_state</td><td>String</td><td>Время смены статуса сообщения</td></tr><tr><td>state</td><td>String</td><td><p>Последний статус сообщения:</p><ul><li>«send» - статус сообщения не получен. В этом случае передается пустой time (time="")</li><li>«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем)</li><li>«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем)</li><li>«deliver» - сообщение доставлено.</li><li>«read» - сообщение прочитано. Конечный статус (не меняется со временем)</li><li>«partly_deliver» - сообщение было отправлено, но статус так и не был получен</li></ul></td></tr><tr><td>num_parts</td><td>Int</td><td>Количество частей SMS</td></tr><tr><td>price</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>

### Пример запроса на получение статуса SMS

```json
[
    {
        "login": "логин",
        "password": "пароль",
        "token":"токен",
        "id_sms": "ID SMS в системе для проверки статуса",
        "detail" : 1
    }
]
```