Skip to content

Отправить сообщение

Request

Создаёт одно или несколько сообщений и возвращает список их идентификаторов.

Поддерживаются два сценария:

  • отправка в существующий диалог: передайте 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
Bodyapplication/jsonrequired
textstring or null, <= 4000 characters
filesArray of integers or null, <= 10 items

Список ID файлов сообщения. Можно передать не более 10 файлов.

dialog_idinteger or null, (int64), >= 1
receiver_idinteger or null, (int64), >= 1
reply_message_idinteger or null, (int64), >= 1
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
    ]
  }'

Responses

Сообщение(я) успешно создано(ы)

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(SendMessageResult)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "Messages sent successfully", "codeError": null, "error_code": null, "data": { "id_messages": [ … ] } }