Skip to content

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

Request

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

Требования:

  • требуется 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""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(GetMessagesResult)required

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

Response
{ "success": true, "message": "Messages received successfully", "codeError": null, "error_code": null, "data": { "messages": [ … ], "offset": null, "limit": 50, "has_more": false, "next_before_id": null } }