Skip to content

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

Request

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

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

  • отправка в существующий диалог: передайте dialog_id
  • отправка напрямую пользователю: передайте receiver_id

Обязательные условия:

  • должен быть указан хотя бы один из параметров dialog_id или receiver_id
  • должно быть заполнено хотя бы одно из полей text или files
  • text, если передан, не должен быть длиннее 4000 символов
  • files, если передан, должен содержать не более 10 положительных ID файлов
  • dialog_id и receiver_id, если переданы, должны быть положительными
  • требуется JWT

Возможные ошибки:

  • 400 invalid_body - запрос не прошёл валидацию или бизнес-проверки
  • 403 forbidden - нет прав на отправку сообщения или доступ к файлам
  • 404 not_found - не найден диалог или получатель
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""unauthorized""not_found""conflict""object_modified_by_another_thread""action_too_late""too_many_request""code_is_gone""forbidden""user_blocked"
dataobject or null(SendMessageResult)required

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

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