Список тредов

GET/threads

Треды, доступные владельцу токена.

Возвращаются треды, где вы состоите в самом треде или в чате, в котором он заведён. Участия в треде достаточно: входить в чат с родительским сообщением не нужно, самостоятельные треды тоже приходят. А вот треды из открытых чатов пространства, где вы не состоите, в список не попадают, хотя сами чаты вам доступны.

Сортировка — по убыванию времени последнего сообщения в треде.

В элементе списка нет ни названия, ни текста: только идентификаторы треда, его чата и родительского сообщения. Чтобы понять, о чём тред, прочитайте его сообщения методом GETСписок сообщений чата по chat_id, а нужный тред по содержанию ищут методом GETПоиск сообщений.

Параметры строки запроса

Фильтрация по времени последнего сообщения в треде: вернутся треды, где оно позже указанного. Значение в ISO-8601, смещение вида +03:00 учитывается, время без смещения считается UTC.

Пример:2025-01-01T00:00:00.000Z

Фильтрация по времени последнего сообщения в треде: вернутся треды, где оно раньше указанного. Значение в ISO-8601, смещение вида +03:00 учитывается, время без смещения считается UTC.

Пример:2025-02-01T00:00:00.000Z

Количество возвращаемых сущностей за один запрос. Целое число вне допустимых значений заменяется ближайшей границей.

Пример:1

По умолчанию:

50

Диапазон:

1 — 50

Курсор для пагинации (из meta.paginate.next_page или meta.paginate.prev_page)

Пример:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Ответ

200OK

The request has succeeded.

Идентификатор треда. Чтобы написать в тред, передайте его в entity_id метода POSTНовое сообщение с entity_type: "thread".

Пример:265142

Идентификатор чата треда. По нему читают сообщения треда методом GETСписок сообщений чата и работают с его участниками.

Пример:2637266155

Идентификатор сообщения, к которому был создан тред. null для самостоятельного треда, созданного без привязки к сообщению.

Пример:154332686

Идентификатор чата сообщения. null для самостоятельного треда, созданного без привязки к сообщению.

Пример:2637266154

Дата и время обновления треда (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ

Пример:2023-02-01T19:20:47.204Z

Метаданные пагинации

Вспомогательная информация

Курсор пагинации следующей страницы

Пример:eyJxZCO2MiwiZGlyIjomSNYjIn3

Курсор пагинации предыдущей страницы. Используется для polling новых записей «сверху» списка.

Пример:eyJxZCO2MiwiZGlyIjoiYXNjIn0

Есть ли ещё данные на следующей странице. На последней странице — false.

Пример:true

Есть ли ещё данные на предыдущей странице. На первом запросе без курсора — false.

Пример:false