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

Получение статуса отправки сообщения (GET)

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

В ответ на GET-запрос возвращается статус доставки сообщения адресату. Сообщение может быть доставлено адресату, находиться на обработке в edna Prisma или платформе провайдера.

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

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

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

к сведению

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

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

В запросе передаётся только идентификатор сообщения id, который был возвращён в ответе на запрос об отправке сообщения.

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

Пример GET-запроса​

http://127.0.0.1:8282/status?id=12345

Если в запросе отсутствует или указан несуществующий идентификатор сообщения, то возвращается сообщение об ошибке Parameter id is missing.

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

<request>
<id>12345</id>
</request>

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

<reply>
<status>enqueued</status>
</reply>

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

{
"id": "12345"
}

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

{
"status": "enqueued"
}

Статусы обработки сообщений​

СтатусОписание
enqueuedСообщение в очереди в edna Prisma
declinedСообщение отклонено в edna Prisma — сработал фильтр
rejectedСообщение отклонено оператором
failedОшибка отправки сообщения в edna Prisma
sentСообщение отправлено
cancelledСообщение отменено на платформе или в edna Prisma
delayed Сообщение отложено на платформе
delivered Сообщение доставлено
undeliveredСообщение не доставлено
readСообщение прочитано. Статус возвращается не всеми мессенджерами
unknownСтатус сообщения неизвестен — ошибка на платформе