Керуйте дошками через API або за допомогою штучного інтелекту

Дошками можна повністю керувати поза межами панелі керування. Два маршрути, одна модель дозволів і така ж поведінка, як у екранів, — оскільки вони звертаються до того самого коду.

REST API

Кожна операція міститься у нашій публічній специфікації OpenAPI зі згенерованими клієнтами для TypeScript, Python, PHP та Go, а інтерфейс командного рядка (CLI) згенеровано на основі тієї ж специфікації. Дошки, стовпці, картки, коментарі, запитання, мітки, учасники та посилання для спільного доступу охоплені повністю.

Кінцеві точки, які ви використовуватимете найчастіше:

• GET /v1/agency/boards — ваші дошки
• GET /v1/agency/boards/{id} — одна дошка зі стовпцями та картками
• POST /v1/agency/boards/{id}/cards — додати роботу
• POST /v1/agency/boards/{id}/cards/{id}/move — перемістити її
• POST /v1/agency/boards/{id}/invites — створити посилання для спільного доступу

Токен посилання для спільного доступу повертається у цьому останньому виклику і лише у ньому. Ми зберігаємо його відбиток, тому немає кінцевої точки, яка могла б прочитати його знову — якщо вашому скрипту потрібне посилання, збережіть його з відповіді.

Сервер MCP

Якщо ви використовуєте штучний інтелект-асистент, який підтримує протокол MCP, підключіть його, і він одразу отримає інструменти для роботи з дошками: перелік дошок, читання однієї дошки повністю, створення дошки, додавання картки, переміщення картки, коментування, створення та відкликання посилання для спільного доступу. Це перетворює запит «підсумуй цей тиждень і надішли Acme посилання» на одну інструкцію замість використання двох систем та копіювання-вставлення.

Варто знати дві речі про ці інструменти:

• Нова картка є внутрішньою, якщо ви не вкажете інше. Асистент, який узагальнює вашу внутрішню роботу, не повинен публікувати цей підсумок вашому клієнту лише через те, що ніхто не сказав цього не робити, тому параметр visibility за замовчуванням має значення «внутрішня» і його потрібно встановлювати як client свідомо.
• Відкликання посилання вимагає підтвердження, оскільки воно також видаляє всіх, хто приєднався за цим посиланням, і інструмент повідомляє вам, скільки саме це було людей, а не просто рапортує про успіх.

Що для цього потрібно

Доступ до API та MCP включено до тарифного плану Boards Business та до кожного хостинг-плану Agency. У тарифах Boards Free та Boards Pro кінцеві точки дошок відповідають повідомленням із поясненням цього.

Ключ API або підключення MCP можуть виконувати лише ті дії, які може виконати особа, що їх створила, у межах доступних їй організацій. Посилання для спільного доступу, створене асистентом, обмежене аналогічним чином: воно не може надати роль, якої не має сама людина, що його авторизує.