Керуйте дошками за допомогою 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 можуть виконувати лише ті дії, які дозволено здійснювати особі, що їх створила, і лише в тих організаціях, де вона має на це право. Посилання для спільного доступу, створене асистентом, обмежене таким самим чином: воно не може надати роль, якою не володіє сама особа, що надає авторизацію.