Webhooks

Кайтен позволяет вам принимать из внешних систем запросы на созданее карточки по заранее созданному “webhook”

Чтобы создать web-адрес Webhook вам нужно зайти в настройки пространства (наведите мышкой на имя пространства в меню слева и войдите в настройки из кнопки "троеточие”).

Далее выберите раздел Webhooks и нажмите Создать внизу справа:

При создании Webhook вы указываете путь по которому будет создана карточка и другие атрибуты карточки.

Обратите внимание на поле Format, в нем вы можете выбрать формат данных, который будет приходить на сторону Кайтен. Если вашей системы, откуда вы передавать данные на webhook, нет в списке, выбирайте формат Kaiten.

Ссылку на созданный webhook можно получить кликнув на иконку и изображением листа бумаги слева от урны:

Форматы (format)

Kaiten

{
  "title": "Card title",
  "description": "...",
  "due_date": "2022-10-01",
  "asap": false,
  "members": [],
  "owner_id": 3424,
  "links": [
    {
      "url": "https://example.com",
      "description": "..."
    }
  ],
  "members": [
     "a@example.com",
     "b@example.com"
  ],
  "tags": [
     "tag 1",
     "tag 2"  
  ]
}

Все параметры тела запроса не обязательны, кроме title (заголовок карточки)