Установить приложение и выключить его

Когда нужно

Команде нужна кнопка или короткая панель на доске, а писать расширение не требуется.

Предусловия

• Вы администратор организации.
• Доска принадлежит этой организации: панель показывает приложения её организации.

Шаги

1. Установите приложение:

curl -X POST https://boards.example.com/api/orgs/$ORG/apps \
  -H "Content-Type: application/json" --cookie "$SESSION" \
  -d '{"appId":"app.hello"}'

2. Откройте доску и нажмите Приложения в верхней панели.
3. Ожидаемый результат: в панели есть приложение и его кнопка.

Проверка действия

1. Нажмите Поздороваться.
2. Ожидаемый результат: панель показывает «Привет, {ваше имя}!».
3. В аудите организации появится app.invoked, в очередь событий — событие app.invoked.

Выключение

1. Выключите приложение:

curl -X PATCH https://boards.example.com/api/orgs/$ORG/apps/app.hello \
  -H "Content-Type: application/json" --cookie "$SESSION" \
  -d '{"enabled":false}'

2. Обновите панель.
3. Ожидаемый результат: приложения в панели нет, его действие отвечает 404. Включение возвращает всё обратно.

Частые ошибки

Куда дальше

Приложения — что именно рисует панель и чего она не делает.