# MMS

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

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

С помощью этого метода можно отправить MMS с изображением на номера операторов МТС и Мегафон.
> ⚠️ По правилам операторов МТС и Мегафон отправка MMS без изображения запрещена. Такое сообщение не будет доставлено абоненту.

## Headers

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

---

## MMS с изображением

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

```json
{
    "@type": "outbound",
    "addresses": {
        "source": "<имя отправителя>",
        "destination": "<номер телефона получателя>"
    },
    "body": {
        "bodyType": "mms",
        "content": "<текст сообщения>",
        "title": "<заголовок сообщения>",
        "image": "<ссылка на изображение для МТС>"
    },
    "properties": {
        "megafon.imageHash": "<хеш изображения Мегафон>"
    },
    "nodeId": "<ID ноды>",
    "requestDelivery": true
}
```
> ⚠️ В связи с особенностями согласования изображений, способ их указания различается в зависимости от оператора:  
> - `body -> image` — для МТС  
> - `properties -> megafon.imageHash` — для Мегафона  
>   
> Если параметр не указан, MMS не будет доставлено абонентам соответствующего оператора.

### Ограничения вложения для оператора МТС

- Заголовок — необязательный; максимум **255** символов  
- Максимальная длина текста при наличии вложения — **268** символов  
- Поддерживаемые форматы: **JPEG**, **GIF**, **JPG**, **PNG**
- Максимальный размер изображения — **800 КБ**  
- Максимальное разрешение изображения — **1024×1024** пикселей

### Ограничения вложения для оператора Мегафон

- Заголовок — необязательный; максимум **55** символов  
- Максимальная длина текста при наличии вложения — **355** символов  
- Поддерживаемые форматы: **JPEG**, **JPG**, **PNG**  
- Максимальный размер изображения — **299 КБ**  
- Максимальное разрешение изображения — **800x800** пикселей