Все теги пространства с числом сотрудников в каждом, независимо от того, к каким чатам они привязаны. Мульти-гостю приходят только теги активных бесед и каналов, где он участник.
Параметр names ищет теги по названиям — это способ получить id по имени, известному из интерфейса. За один запрос он принимает не больше 100 имён, на большее число метод отвечает 400 с кодом too_long.
Кто состоит в конкретном теге, отдаёт GETСписок сотрудников тега.
Параметры строки запроса
names[]
array of strings
Массив названий тегов, по которым вы хотите отфильтровать список
Пример:
["Design","Product"]Количество:
<= 100 элементовlimit
integer, (int32)
Количество возвращаемых сущностей за один запрос. Целое число вне допустимых значений заменяется ближайшей границей.
Пример:
1По умолчанию:
50Диапазон:
1 — 50cursor
string
Курсор для пагинации (из
meta.paginate.next_page или meta.paginate.prev_page)Пример:
eyJpZCI6MTAsImRpciI6ImFzYyJ9Ответ
200OK
The request has succeeded.
data[]
array of objects
*id
integer, (int32)
*Идентификатор тега
Пример:
9111name
string
*Название тега
Пример:
DesignДлина:
<= 255 символовusers_count
integer, (int32)
*Количество сотрудников, которые имеют этот тег
Пример:
6meta
object
*Метаданные пагинации
paginate
object
*Вспомогательная информация
next_page
string
*Курсор пагинации следующей страницы
Пример:
eyJxZCO2MiwiZGlyIjomSNYjIn3prev_page
string
Курсор пагинации предыдущей страницы. Используется для polling новых записей «сверху» списка.
Пример:
eyJxZCO2MiwiZGlyIjoiYXNjIn0has_next
boolean
Есть ли ещё данные на следующей странице. На последней странице —
false.Пример:
truehas_prev
boolean
Есть ли ещё данные на предыдущей странице. На первом запросе без курсора —
false.Пример:
false