Управлявайте таблата от API или от AI асистент

Таблиците могат да се управляват изцяло извън таблото за управление. Два маршрута, един модел на разрешения и същото поведение като на екраните — тъй като те извикват един и същ код.

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

Ако използвате AI асистент, който поддържа MCP, свържете го и той получава инструменти за табла директно: извеждане на списък с табла, пълно четене на едно от тях, създаване на табло, добавяне на карта, преместване на карта, коментиране, създаване на връзка за споделяне и отменянето ѝ. Това превръща фразата "обобщи тази седмица и изпрати връзка на Acme" в една инструкция вместо в две системи и копиране-поставяне.

Две неща, които си струва да знаете за инструментите:

• Новата карта е вътрешна, освен ако не посочите друго. Асистент, който обобщава вашата вътрешна работа, не трябва да публикува това обобщение на вашия клиент, само защото никой не е казал друго, затова стойността по подразбиране за visibility е вътрешна и трябва нарочно да бъде зададена на client.
• Отмяната на връзка изисква потвърждение, тъй като тя премахва и всички, които са се присъединили чрез тази връзка — и инструментът ви казва колко точно хора са били те, вместо да докладва просто за успешен завършек.

Какво е необходимо

Достъпът до API и MCP е включен в Boards Business и във всички хостинг планове за агенции. В Boards Free и Boards Pro крайните точки за табла връщат съобщение, което уведомява за това.

API ключ или MCP връзка могат да правят само това, което може да направи човекът, който ги е създал, в организациите, в които той има тези права. Връзката за споделяне, създадена от асистент, е ограничена по същия начин: тя не може да даде роля, която упълномощаващият я човек сам по себе си не притежава.