# Отправка SMS, Viber, Flash SMS, WAP-Push

## Отправка SMS, Viber, Flash SMS, WAP-Push

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

#### 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 | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру.                                                                                                                                                                                                                                                         |
| message.type\_send\_1<mark style="color:red;">\*</mark> | String | Тип отправляемого сообщения **`viber`** или **`sms`**                                                                                                                                                                                                                                                                                                       |
| message.sender<mark style="color:red;">\*</mark>        | String | <p>Отправитель SMS. 
<br><mark style="color:orange;">Именно это значение будет выводиться на телефоне абонента в поле от кого SMS</mark></p>                                                                                                                                                                                                                |
| message.phones.phone<mark style="color:red;">\*</mark>  | Int    | Номер абонента, которому адресована SMS                                                                                                                                                                                                                                                                                                                     |
| message.phones.client\_id\_sms                          | Int    | <p>число присваиваемое клиентом <br><mark style="color:orange;">Позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS</mark></p>                                                                                 |
| message.text<mark style="color:red;">\*</mark>          | String | Текст обычного SMS или описание WAP-ссылки                                                                                                                                                                                                                                                                                                                  |
| message.phones.validity\_period                         | Date   | <p>Дата и время, после которых не будут делаться попытки доставить SMS в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где,<br>    YYYY - год,<br>    MM - месяц,<br>    DD - день,<br>    HH - часы, </p><p>    MM - минуты</p><p>    SS - секунды</p><p><mark style="color:orange;">Если не задано, то SMS имеет максимальный срок жизни.</mark> </p> |

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

```json
{
    "information":
        [
            {
                "state": "Статус", 
                "id_sms": "ID SMS в системе для проверки статуса",
                "error": "Сообщение об ошибке."
            },
            {
                "state": "Статус", 
                "id_sms": "ID SMS в системе для проверки статуса",
                "error": "Сообщение об ошибке."
            }
        ]
}
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="144.33333333333331">Параметр</th><th width="133">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>state</td><td>String</td><td>Статус сообщения («send»), если SMS была отправлена</td></tr><tr><td>id_sms</td><td>Int</td><td><p>Номер SMS сообщения. Используется для проверки статуса SMS.</p><p><mark style="color:orange;">Если в процессе отправки SMS произошла ошибка, то id_sms не передается</mark></p></td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки при статусе ответа <mark style="color:green;"><strong>200</strong></mark>:</p><ul><li>Неправильный формат JSON документа </li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul><p></p><p>Текст ошибки при статусе ответа <mark style="color:red;"><strong>400</strong></mark>:</p><ul><li>У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером</li><li>Закончились SMS</li><li>Аккаунт заблокирован</li><li>Укажите номер телефона</li><li>Номер телефона присутствует в стоп-листе</li><li>Данное направление закрыто для вас</li><li>Данное направление закрыто</li><li>Текст SMS отклонен модератором</li><li>Нет отправителя</li><li>Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых</li><li>Номер телефона должен быть меньше 15 символов</li><li>Нет текста сообщения</li><li>Нет ссылки</li><li>Укажите название контакта и хотя бы один параметр для визитной карточки</li><li>Такого отправителя нет</li><li>Отправитель не прошел модерацию</li></ul></td></tr></tbody></table>

### Пример запроса на отправку&#x20;

{% code lineNumbers="true" fullWidth="false" %}

```json
{
    "login": "логин",
    "password": "пароль",
    "token": "токен",
    "message": [
        {
            "type_send_1":"sms",
            "sender":" Отправитель 1",
            "text":"Текст сообщения 1",
            "phones":[
                {
                    "phone":"79612242243",
                    "client_id_sms":"101",
                    "validity_period":"2001-12-31 15:34:54"
                },
                {
                    "phone":"79612242244",
                    "client_id_sms":"102",
                    "validity_period":"2001-12-31 15:34:54"
                }
            ]
        },
        {
            "type_send_1":"sms",
            "sender":" Отправитель 2",
            "text":"Текст сообщения 2",
            "phones":[
                {
                "phone":"79612242245",
                    "client_id_sms":"103",
                    "validity_period":"2001-12-31 15:34:54"
                }
            ]
        }
    ]
}
```

{% endcode %}