Получить сообщения диалога

Request

Возвращает сообщения диалога. Для новых клиентов рекомендуется cursor-пагинация: первый запрос выполняется с limit, последующие — с before_id, равным next_before_id из предыдущего ответа. Legacy-параметр offset сохранён для обратной совместимости и не может использоваться вместе с before_id.

Требования:

требуется JWT

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

400 invalid_body - параметры не прошли валидацию или одновременно переданы offset и before_id
403 forbidden - нет доступа к диалогу
404 not_found - диалог не найден

Security

bearerAuth or jwtCookie

Query

id_dialoginteger, (int64), >= 1required

Example:id_dialog=10

offsetinteger, (int32), [ 0 .. 100000 ]

Example:offset=0

before_idinteger, (int64), >= 1

limitinteger, [ 1 .. 100 ]

Default:50

curl -i -X GET \
  'https://felmee.com/api/messages?id_dialog=10&offset=0&before_id=1&limit=50' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

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(GetMessagesResult)required

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

Response

{
  "success": true,
  "message": "Messages received successfully",
  "error_code": null,
  "data": {
    "messages": [ … ]
  }
}