Создаёт одно или несколько сообщений и возвращает список их идентификаторов.
Поддерживаются два сценария:
- отправка в существующий диалог: передайте
dialog_id - отправка напрямую пользователю: передайте
receiver_id
Обязательные условия:
- должен быть указан ровно один из параметров
dialog_idилиreceiver_id; одновременная передача обоих даёт 400 invalid_body - должно быть заполнено хотя бы одно из полей
textилиfiles text, если передан, не должен быть длиннее 4000 символовfiles, если передан, должен содержать не более 10 положительных ID файлов- все
filesдолжны иметь статусUPLOADED; иначе весь запрос отклоняется без создания сообщений dialog_idиreceiver_id, если переданы, должны быть положительными- требуется JWT
Возможные ошибки:
400 invalid_body- запрос не прошёл валидацию или бизнес-проверки403 forbidden- нет прав на отправку сообщения или доступ к файлам404 not_found- не найден диалог или получатель409 file_not_ready- есть неготовые вложения; проверьте файл через GET /api/file/{id}
Готовность прикрепляемых файлов: все files, независимо от типа (фото, видео, аудио, голосовое сообщение или документ), должны иметь статус UPLOADED. PENDING, FAILED или исчезновение файла после проверки доступа приводят к HTTP 409 file_not_ready; весь запрос отклоняется до сохранения сообщений, включая текстовую часть. До проверки готовности проверяются права доступа. Каждый файл готов после успешного ответа POST /api/file/upload.
Security
bearerAuth or jwtCookie
- https://felmee.comhttps://felmee.com/api/messages/send
- http://localhost:8080http://localhost:8080/api/messages/send
curl -i -X POST \
https://felmee.com/api/messages/send \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"dialog_id": 10,
"reply_message_id": 99,
"text": "Hello",
"files": [
60
]
}'Сообщение(я) успешно создано(ы)
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Response
{ "success": true, "message": "Messages sent successfully", "codeError": null, "error_code": null, "data": { "id_messages": [ … ] } }