# E-mail

## Отправка E-mail-сообщения

<mark style="color:green;">`POST`</mark> `https://external-api.i-dgtl.ru/message`

Метод позволяет отправить одиночное E-mail-сообщение.

#### Headers

| Name          | Type   | Description                 |
| ------------- | ------ | --------------------------- |
| Content-Type  | string | application/json            |
| Authorization | string | 'nodeID:password' \| base64 |

#### Request Body

| Name            | Type    | Description                                                                                                                                                                                                                             |
| --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| @type           | string  | Тип сообщения, имеет постоянное значение оutbound (исходящее).                                                                                                                                                                          |
| addresses       | object  | Объект, содержащий адреса отправителя и получателя.                                                                                                                                                                                     |
| source          | string  | E-mail адрес отправителя.                                                                                                                                                                                                               |
| destination     | string  | E-mail адрес получателя.                                                                                                                                                                                                                |
| body            | object  | Объект, в котором передаётся содержимое сообщения.                                                                                                                                                                                      |
| bodyType        | boolean | Тип сообщения (e-mail).                                                                                                                                                                                                                 |
| html            | string  | Формат почтового сообщения (HTML - true, plain text - false).                                                                                                                                                                           |
| content         | string  | Полный текст сообщения (для сообщений в формате HTML передаётся со всеми необходимыми тэгами).                                                                                                                                          |
| senderName      | string  | Отображаемое имя отправителя.                                                                                                                                                                                                           |
| subject         | integer | Тема сообщения.                                                                                                                                                                                                                         |
| nodeId          | integer | Номер ноды.                                                                                                                                                                                                                             |
| requestDelivery | boolean | Указывает, cледует ли предоставлять отчёт о доставке после отправки сообщения (true\|false).                                                                                                                                            |
| expirationDate  | integer | <p>Время, до которого будет ожидаться получение статуса от оператора.<br>Тип значения - <strong>timestamp</strong> в миллисекундах или в формате ISO 8601.<br>По умолчанию составляет 24 часа с момента отправки сообщения.<br><br></p> |

::::{tab-set}

:::{tab-item} 200 В случае успешного запроса возвращается ответ, в котором указан идентификатор сообщения и время отправки сообщения в формате Unix Timestamp.

```
{
    "id": "41937aa1-6322-1224-4183-aa0003447145",
    "timestamp": 1632212244197,
    "code": 200
}
```
:::


:::{tab-item} 400 Неверный синтаксис запроса

```
{
    "timestamp": 1632212293815,
    "code": 400,
    "description": "incorrect request body"
}
```
:::

::::


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

```
POST https://external-api.i-dgtl.ru/message
Authorization: Basic Mzk5OTk6MTIzNjU0
Content-Type: application/json

{
   "@type": "outbound",
   "addresses": {
       "source": "test@i-dgtl.ru",
       "destination": "test2@i-dgtl.ru"
   },
   "body": {
       "bodyType": "email",
       "html": true,
       "content": "Have a nice day!",
       "senderName": "Test1",
       "subject": "Testing"
   },
   "nodeId": 31937,
   "requestDelivery": true
}
```