> For the complete documentation index, see [llms.txt](https://apidocs.webcom.mobi/ru/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/ru/proverka-statusa-soobsheniya/post-zapros.md).

# POST запрос

Спецификации для запроса статуса: JSON, XML, HTTP GET

{% tabs %}
{% tab title="XML" %}
Метод отправки **`POST`**

Кодировка XML-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/xml; charset=utf-8;`**

Адрес для запроса: **`https://my3.webcom.mobi/xml/state.php`**

### Параметры запроса на отправку сообщения <a href="#parametry-zaprosa-na-otpravku-soobsheniya-2" id="parametry-zaprosa-na-otpravku-soobsheniya-2"></a>

<table><thead><tr><th width="158">Параметр</th><th width="110.66666666666666">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.login</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Ваш логин в системе</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.password</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Ваш пароль в системе</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.token</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.get_state</mark></p><p><mark style="color:blue;">.id_sms</mark>*</p></td><td>Int</td><td>Номер сообщения, полученный в ответном XML-документа в процессе отправки сообщения.</td></tr></tbody></table>

&#x20;\*- обязательный параметр

### В случае получения правильного XML-документа

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

<table><thead><tr><th width="190.66666666666666">Параметр</th><th width="124">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>response</p><p><mark style="color:blue;">.state</mark></p><p><mark style="color:green;">[id_sms]</mark></p></td><td>Int</td><td>Номер сообщения, полученный в ответном XML-документа в процессе отправки сообщения</td></tr><tr><td><p>response</p><p><mark style="color:blue;">.state</mark></p><p><mark style="color:green;">[time]</mark></p></td><td>Date</td><td>Время изменения статуса</td></tr><tr><td><p>response</p><p><mark style="color:blue;">.state</mark></p></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» - сообщение прочитано. Конечный статус (не меняется со временем) <em>для viber сообщения</em></li><li>«partly_deliver» - сообщение было отправлено, но статус так и не был получен</li></ul></td></tr><tr><td><p>response</p><p><mark style="color:blue;">.state</mark></p><p><mark style="color:green;">[sms]</mark></p></td><td>String</td><td>Статус SMS сообщения. </td></tr><tr><td><p>response</p><p><mark style="color:blue;">.state</mark></p><p><mark style="color:green;">[viber]</mark></p></td><td>String</td><td>Статус Viber сообщения. </td></tr></tbody></table>

### &#x20;В случае возникновения ошибки в отправленном XML-документе

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

<table><thead><tr><th width="197.66666666666666">Параметр</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>response</p><p><mark style="color:blue;">.error</mark></p></td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа </li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul></td></tr></tbody></table>

### &#x20;Пример 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>
```

{% endtab %}

{% tab title="JSON" %}
Метод отправки **`POST`**

Кодировка JSON-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/json; charset=utf-8;`**

Адрес для запроса: **`https://my3.webcom.mobi/json/state.php`**

### Параметры запроса на отправку сообщения <a href="#parametry-zaprosa-na-otpravku-soobsheniya-2" id="parametry-zaprosa-na-otpravku-soobsheniya-2"></a>

<table><thead><tr><th width="158">Параметр</th><th width="110.66666666666666">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>login*</td><td>String</td><td>Ваш логин в системе</td></tr><tr><td>password*</td><td>String</td><td>Ваш пароль в системе</td></tr><tr><td>token*</td><td>String</td><td>Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру</td></tr><tr><td>id_sms*</td><td>Int</td><td>Номер сообщения, полученный в ответном XML-документа в процессе отправки сообщения.</td></tr><tr><td>detail</td><td>Int</td><td>0 или 1 в случае необходимости получения кол-во частей и цены за одну часть сообщения</td></tr></tbody></table>

&#x20;\*- обязательный параметр

### В случае получения правильного JSON-документа

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

<table><thead><tr><th width="190.66666666666666">Параметр</th><th width="124">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>id_sms</td><td>Int</td><td>Номер сообщения, полученный в ответном JSON-документа в процессе отправки сообщения</td></tr><tr><td>time_change_state</td><td>Date</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» - сообщение прочитано. Конечный статус (не меняется со временем) <em>для viber сообщения</em></li><li>«partly_deliver» - сообщение было отправлено, но статус так и не был получен</li></ul></td></tr><tr><td>num_parts</td><td>String</td><td>Количество частей SMS</td></tr><tr><td>price</td><td>String</td><td>Цена за одну часть SMS</td></tr></tbody></table>

### &#x20;В случае возникновения ошибки в отправленном JSON-документе

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

<table><thead><tr><th width="188.66666666666663">Параметр</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><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>

### &#x20;Пример JSON запроса

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

{% endtab %}

{% tab title="HTTP GET" %}
Метод отправки **`GET`**

Адрес для запроса: **`https://my3.webcom.mobi/sendsms.php`**

Все передаваемые значение необходимо закодировать.

### Параметры запроса на отправку сообщения <a href="#parametry-zaprosa-na-otpravku-soobsheniya-2" id="parametry-zaprosa-na-otpravku-soobsheniya-2"></a>

<table><thead><tr><th width="158">Параметр</th><th width="110.66666666666666">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>user*</td><td>String</td><td>Ваш логин в системе</td></tr><tr><td>pwd*</td><td>String</td><td>Ваш пароль в системе</td></tr><tr><td>token*</td><td>String</td><td>Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру</td></tr><tr><td>smsid*</td><td>Int</td><td>Номер сообщения, полученный в ответном XML-документа в процессе отправки сообщения.</td></tr></tbody></table>

&#x20;\*- обязательный параметр

### Ответ на GET запрос

В ответ придет состояние **`state`** по переданному **`smsid`**, варианты ответа в таблице ниже.

### Ответ GET запроса статуса <a href="#otvet-get-zaprosa-statusa" id="otvet-get-zaprosa-statusa"></a>

<table><thead><tr><th width="158">Параметр</th><th width="110.66666666666666">Тип</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» - сообщение прочитано. Конечный статус (не меняется со временем) <em>для viber сообщения</em></li><li>«partly_deliver» - сообщение было отправлено, но статус так и не был получен</li></ul></td></tr></tbody></table>

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

{% code overflow="wrap" %}

```
http://lk.mysmpp.ru/sendsms.php?user=пользователь&pwd=пароль&smsid=ID_SMS
```

{% endcode %}
{% endtab %}
{% endtabs %}