Отправка списка сообщений (POST)
В результате выполнения POST-запроса сообщения отправляются в edna Prisma для доставки адресатам. В ответе возвращаются идентификаторы и статусы обработки для каждого сообщения.
Формирование текста сообщений, указание способа доставки и подстановка параметров такие же, как у метода для отправки сообщений.
Отправка сообщений (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.
Параметры каждого сообщения такие же, как у метода для отправки сообщений.
Отправка сообщений (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]"
}
]
}