> For the complete documentation index, see [llms.txt](https://apidocs.webcom.mobi/ru2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.webcom.mobi/ru2/type/specifikaciya-xml/zapros-statusa-sms/post-zapros.md).

# POST запрос

## POST запрос на получение статуса сообщения

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

#### Headers

| Name         | Type  | Description                    |
| ------------ | ----- | ------------------------------ |
| Content-type | Sting | **`text/xml; charset=utf-8;`** |

#### Request Body

| Name                                                 | Type  | Description                                                                                        |
| ---------------------------------------------------- | ----- | -------------------------------------------------------------------------------------------------- |
| login.value<mark style="color:red;">\*</mark>        | Sting | Ваш логин в системе                                                                                |
| token.value<mark style="color:red;">\*</mark>        | Sting | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру |
| password.value<mark style="color:red;">\*</mark>     | Sting | Ваш пароль в системе                                                                               |
| get\_state.id\_sms<mark style="color:red;">\*</mark> | Int   | Номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMSсообщения.          |

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

```xml
<?xml version="1.0" encoding="utf-8" ?>
<response>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус">Статус</state>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус" viber="Статус">Статус</state>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" viber="Статус">Статус</state>
</response>
```

{% endtab %}

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

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>текст ошибки</error>
</response>
```

{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="153.33333333333331">Параметр</th><th width="149">Тип данных</th><th>Описание</th></tr></thead><tbody><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>state.id_sms</td><td>Int</td><td>Номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMS сообщения</td></tr><tr><td>state.time</td><td>String</td><td>Время изменения статуса</td></tr><tr><td>state.sms, state.viber</td><td>String</td><td><p>Статус сообщения. </p><p><mark style="color:red;">Название поля зависит от типа отправляемого и досылаемого сообщения</mark></p></td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа </li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul></td></tr></tbody></table>

### Пример XML запроса

```xml
<?xml  version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
    <get_state>
        <id_sms>IDSMS в системе для проверки статуса</id_sms>
        <id_sms>IDSMS в системе для проверки статуса</id_sms>
        <id_sms>IDSMS в системе для проверки статуса</id_sms>
        <id_sms>IDSMS в системе для проверки статуса</id_sms>
    </get_state>
</request>
```