Kaiten

Документация и инструкции

To Kaiten
Документация и инструкцииСправочная информацияЧто нового в Кайтене

Исправление формата пользовательских полей в API

Мы привели к единому формату значения пользовательских полей типа User в API, чтобы интеграции работали предсказуемо и не останавливались из-за разных ответов в похожих запросах.

Раньше одно и то же поле типа User возвращалось в разном формате в разных методах API:

  • GET /cards/{id} - возвращал uid (строка UUID)

  • GET /cards (список) - возвращал id (integer)

В одних запросах приходил uid пользователя, в других — числовой id или расширенный объект. Из-за этого автоматизации и отчеты могли работать нестабильно.

Теперь формат можно контролировать с помощью query-параметра broken_api:

  • broken_api=true — возвращается uid пользователя (строка);

  • broken_api=false — возвращается числовой id пользователя.

Пример:
GET /api/latest/cards/123?broken_api=true
-> { “properties”: { “id_9”: [“6f826962-b0a1-4139-…”] } }

GET /api/latest/cards/123?broken_api=false
-> { “properties”: { “id_9”: [42] } }

Параметр доступен в методах API получения карточки и списка карточек:

Подробнее: developers.kaiten.ru

Важные рекомендации

До 1 апреля 2026 года по умолчанию используется broken_api=true, чтобы существующие интеграции продолжали работать без изменений.

После этой даты поведение по умолчанию изменится на broken_api=false: API будет возвращать числовой id пользователя.

Если вы используете пользовательские поля типа «User» в интеграциях, рекомендуем заранее указать нужное значение параметра broken_api и подготовиться к смене формата.

Если у вас появятся вопросы — пишите в службу поддержки.