Изменения в публичном API Kaiten с 1 октября 2026 года

С 1 октября изменится работа нескольких методов API Kaiten. Для списков появятся обязательная пагинация и ограничение в 100 записей за один запрос. С 1 ноября карточки перестанут входить в ответы GET /api/{latest,v1}/boards/:id и GET /api/{latest,v1}/spaces/:space_id/boards/:id.

До 1 октября добавьте в интеграции обработку limit и offset. До 1 ноября перенесите получение карточек из этих маршрутов в GET /api/{latest,v1}/cards.

Как работает пагинация

Параметр limit определяет количество записей в ответе. Максимальное значение — 100.

Параметр offset определяет, сколько записей нужно пропустить:

Запрос вернет первые 100 записей: ?limit=100&offset=0

Запрос вернет следующие 100 записей: ?limit=100&offset=100

Увеличивайте offset на 100, пока API не вернет меньше 100 записей.

Что изменится с 1 октября

GET /api/{latest,v1}/boards/:id

• В ответе будет не более 100 карточек.

• Для получения полного списка используйте GET /api/{latest,v1}/cards с параметрами board_id, condition=1, limit и offset.

GET /api/{latest,v1}/spaces/:space_id/boards/:id

• В ответе будет не более 100 карточек.

• Для получения полного списка используйте GET /api/{latest,v1}/cards с параметрами board_id, condition=1, limit и offset.

GET /api/{latest,v1}/company/custom-properties/:property_id/catalog-values

• Максимальный limit — 100. Без limit API вернет первые 100 значений.

GET /api/{latest,v1}/company/custom-properties/:property_id/select-values

• Пагинация будет применяться при любом значении v2_select_search.

• Максимальный limit — 100. Без limit API вернет первые 100 значений.

GET /api/{latest,v1}/company/custom-properties

• Максимальный limit — 100. Без limit API вернет первые 100 свойств.

• Параметр include_values=true перестанет поддерживаться.

• Значения полей типа «Выбор» запрашивайте через select-values, записи каталогов — через catalog-values.

GET /api/{latest,v1}/documents

• Максимальный limit — 100. Без limit API вернет первые 100 документов.

GET /api/{latest,v1}/document-groups

• Максимальный limit — 100. Без limit API вернет первые 100 папок.

GET /api/{latest,v1}/spaces/:space_id/users

• Запрос без пагинации больше не будет возвращать всех пользователей пространства.

• Максимальный limit — 100. Без limit API вернет первых 100 пользователей.

GET /api/{latest,v1}/company/users

• Максимальный limit — 100. Без limit API вернет первых 100 пользователей.

GET /api/{latest,v1}/groups/:group_uid/users

• Максимальный limit — 100. Без limit API вернет первых 100 участников.

GET /api/{latest,v1}/cards/:card_id/allowed-users

• Максимальный limit — 100. Без limit API вернет первых 100 пользователей.

GET /api/{latest,v1}/cards/:card_id/comments

• Максимальный limit — 100. Без limit API вернет первые 100 комментариев.

GET /api/{latest,v1}/cards/:card_id/children

• Максимальный limit — 100. Без limit API вернет первые 100 дочерних карточек.

GET /api/{latest,v1}/cards/:card_id/parents

• Максимальный limit — 100. Без limit API вернет первые 100 родительских карточек.

GET /api/{latest,v1}/cards/:card_id/time-logs

• Максимальный limit — 100. Без limit API вернет первые 100 записей.

• Параметр for_date останется дополнительным фильтром.

GET /api/{latest,v1}/spaces/:space_id/automations

• Максимальный limit — 100. Без limit API вернет первые 100 автоматизаций.

GET /api/{latest,v1}/spaces

• Максимальный limit — 100. Без limit API вернет первые 100 пространств.

Что изменится с 1 ноября

• GET /api/{latest,v1}/boards/:id

  • Карточки перестанут входить в ответ.

  • Для их получения используйте:

    GET /api/{latest,v1}/cards?board_id={board_id}&condition=1&limit=100&offset=0

• GET /api/{latest,v1}/spaces/:space_id/boards/:id

  • Карточки перестанут входить в ответ.

  • Для их получения используйте:

    GET /api/{latest,v1}/cards?board_id={board_id}&condition=1&limit=100&offset=0

Полезные материалы

• Интеграции API

• Документация API Kaiten

• Получение списка карточек

• Получение доски внутри пространства