Разбирайте карточки Kaiten по доскам и держите сроки

Агент ходит в API вашего Kaiten по адресу, который вы указали при подключении, — облачный https://ваша-компания.kaiten.ru или собственный домен, если Kaiten стоит на ваших серверах. Он читает пространства, доски и колонки, карточки со сроками, ответственными, тегами, чек-листами и пользовательскими свойствами, комментарии и приложенные файлы, а из этого собирает разбор по доскам: что просрочено, что висит без ответственного, что не двигалось.

Устройство Kaiten агент учитывает буквально: состояние работы здесь задаётся не отдельным полем статуса, а колонкой, в которой лежит карточка, поэтому «сделано» он определяет по положению на доске, а не по надписи в самой карточке. Структуру он читает так же буквально: пространство, доска, колонка, карточка — четыре уровня, и один и тот же вопрос про просроченное на уровне доски и на уровне пространства даёт разные списки, поэтому агент всегда называет срез, по которому считал.

На запись агент делает ровно то, о чём его попросили: заводит карточку в нужном пространстве и колонке, проставляет ответственного, срок и теги, дописывает комментарий, переносит карточку между колонками и досками, убирает готовое в архив. Перед переносом он проверяет, что доска и колонка существуют и открыты ключу, а после изменения перечитывает карточку — чтобы показать её фактическое состояние, а не то, что отправил.

Частоту обращений агент выдерживает сам, чтобы не упереться в ограничения сервера, и большие доски забирает страницами, а не одним запросом. О новых карточках, комментариях и файлах он узнаёт вебхуками Kaiten, а не опросом по кругу, поэтому свежая карточка попадает в сводку без задержки на следующий обход. Если данных нет или ключ их не видит, агент скажет об этом прямо, а не покажет пустую таблицу.