Для разработчиков

Список тегов сотрудников

GET/group_tags
group_tags:read

Метод для получения актуального списка тегов сотрудников. Названия тегов являются уникальными в компании.

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

names[]
array of strings
Массив названий тегов, по которым вы хотите отфильтровать список
Пример:["Design","Product"]
limit
integer, (int32)
Количество возвращаемых сущностей за один запрос
Пример:1
По умолчанию:
50
Диапазон:
1 — 50
cursor
string
Курсор для пагинации (из meta.paginate.next_page или meta.paginate.prev_page)
Пример:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Ответ

200OK
The request has succeeded.
data[]
array of objects
*
id
integer, (int32)
*
Идентификатор тега
Пример:9111
name
string
*
Название тега
Пример:Design
users_count
integer, (int32)
*
Количество сотрудников, которые имеют этот тег
Пример:6
meta
object
*
Метаданные пагинации
paginate
object
*
Вспомогательная информация
next_page
string
*
Курсор пагинации следующей страницы
Пример:eyJxZCO2MiwiZGlyIjomSNYjIn3
prev_page
string
Курсор пагинации предыдущей страницы. Используется для polling новых записей «сверху» списка.
Пример:eyJxZCO2MiwiZGlyIjoiYXNjIn0
has_next
boolean
Есть ли ещё данные на следующей странице. На последней странице — false.
Пример:true
has_prev
boolean
Есть ли ещё данные на предыдущей странице. На первом запросе без курсора — false.
Пример:false
Список тегов сотрудников
# Добавьте --all для автоматической пагинацииpachca group-tags list \  --names=Design,Product \  --limit=1 \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": [    {      "id": 9111,      "name": "Design",      "users_count": 6    }  ],  "meta": {    "paginate": {      "next_page": "eyJxZCO2MiwiZGlyIjomSNYjIn3",      "prev_page": "eyJxZCO2MiwiZGlyIjoiYXNjIn0",      "has_next": true,      "has_prev": false    }  }}