Перейти к основному содержимому

Отправка списка сообщений (POST)

Обновлено: 10 августа 2026

В результате выполнения POST-запроса сообщения отправляются в edna Prisma для доставки адресатам. В ответе возвращаются идентификаторы и статусы обработки для каждого сообщения.

подсказка

Формирование текста сообщений, указание способа доставки и подстановка параметров такие же, как у метода для отправки сообщений.

File IconОтправка сообщений (POST)

URL-адрес подключения​

POST-запрос выполняется на URL-адрес следующего вида:

http://gate.example.com/port/send/messages, где gate.example.com — адрес edna Prisma; port — номер порта для подключения к edna Prisma. Для облачной версии значение задается в настройках компонента и выбирается из диапазона 8081–8088.

к сведению

Если шлюз эксплуатируется в закрытом контуре, то вид URL зависит от способа развертывания. Например, при использовании Docker адрес будет иметь следующую структуру: https://gate.example.com:port/...

Параметры запроса​

В теле XML-запроса передаётся структура messages, содержащая множество вложенных структур message с параметрами сообщений. В JSON параметры сообщений вложены в массив message.

подсказка

Параметры каждого сообщения такие же, как у метода для отправки сообщений.

File IconОтправка сообщений (POST)

Примеры запросов и ответов​

Пример запроса в формате XML​

<messages>
<message>
<id>12345032</id>
<address>79112223344</address>
<text>test password 1234</text>
<priority>low</priority>
</message>
<message>
<id>12345033</id>
<address>79112223344</address>
<text>test password 1234</text>
<priority>low</priority>
</message>
</messages>

Пример ответа на корректный запрос в формате XML​

<results>
<result>
<id>12345032</id>
<status>OK</status>
</result>
<result>
<id>12345033</id>
<status>OK</status>
</result>
</results>

Пример сообщения об ошибке в ответ на запрос в формате XML​

<results>
<result>
<id>12345032</id>
<status>OK</status>
</result>
<result>
<id>12345033</id>
<status>error-duplicate-id</status>
<detail>duplicate external ids: [12345026]</detail>
</result>
</results>

Пример тела запроса в формате JSON​

{
"message": [
{
"id": "12345022",
"address": "79112223344",
"subject": "BANK",
"text": "test password 1234",
"priority": "low",
"startTime": "2022-04-25T18:30:00"
},
{
"id": "12345023",
"address": "79112223344",
"subject": "BANK",
"text": "test password 1234",
"priority": "low",
"startTime": "2022-04-25T18:30:00"
}
]
}

Пример ответа на корректный запрос в формате JSON​

{
"result": [
{
"id": "12345025",
"status": "OK"
},
{
"id": "12345026",
"status": "OK"
}
]
}

Пример сообщения об ошибке в ответ на запрос в формате JSON​

{
"result": [
{
"id": "12345025",
"status": "OK"
},
{
"id": "12345026",
"status": "error-duplicate-id",
"detail": "duplicate external ids: [12345026]"
}
]
}