Получение статуса отправки сообщения (GET)
В ответ на 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 | Статус сообщения неизвестен — ошибка на платформе |