Ovládejte nástěnky přes API nebo pomocí asistenta s umělou inteligencí

Nástěnky lze plně ovládat i mimo administrační rozhraní. Dvě trasy, jeden model oprávnění a stejné chování jako u obrazovek – protože volají stejný kód.

Rozhraní REST API

Každá operace je uvedena v naší veřejné specifikaci OpenAPI s generovanými klienty pro jazyky TypeScript, Python, PHP a Go a příkazový řádek (CLI) je generován ze stejné specifikace. Zahrnuty jsou nástěnky, sloupce, karty, komentáře, otázky, štítky, členové a odkazy pro sdílení.

Koncové body, které budete používat nejčastěji:

• GET /v1/agency/boards — vaše nástěnky
• GET /v1/agency/boards/{id} — jedna nástěnka včetně sloupců a karet
• POST /v1/agency/boards/{id}/cards — přidat práci
• POST /v1/agency/boards/{id}/cards/{id}/move — přesunout práci
• POST /v1/agency/boards/{id}/invites — vytvořit odkaz pro sdílení

Token odkazu pro sdílení se vrací při posledním volání, a to pouze při něm. Ukládáme jeho otisk, takže neexistuje žádný koncový bod, který by jej mohl přečíst zpět – pokud váš skript odkaz potřebuje, uložte si jej z odpovědi.

Server MCP

Pokud používáte AI asistenta, který podporuje protokol MCP, připojte jej a získá přímý přístup k nástrojům pro správu nástěnek: zobrazení seznamu nástěnek, úplné přečtení nástěnky, vytvoření nástěnky, přidání karty, přesun karty, komentář, vytvoření odkazu pro sdílení a jeho zrušení. Díky tomu se příkaz "shrň tento týden a pošli společnosti Acme odkaz" stane jedním krokem namísto práce ve dvou systémech a kopírování.

Dvě věci, které je dobré o těchto nástrojích vědět:

• Nová karta je ve výchozím nastavení interní, pokud výslovně nestanovíte jinak. Asistent sumarizující vaši interní práci nesmí toto shrnutí publikovat vašemu klientovi jen proto, že nebylo řečeno jinak, takže hodnota visibility je ve výchozím nastavení nastavena na interní a je nutné ji záměrně změnit na client.
• Zrušení platnosti odkazu vyžaduje potvrzení, protože zároveň odebere všechny, kteří se přes tento daný odkaz připojili – a nástroj vám místo pouhého hlášení o úspěchu sdělí, kolika lidí se to týkalo.

Co k tomu potřebujete

Přístup k rozhraní API a serveru MCP je součástí tarifů Boards Business a každého hostingového plánu Agency. V tarifech Boards Free and Boards Pro vrací koncové body nástěnek odpovídající chybovou zprávu.

Klíč API nebo připojení MCP může provádět pouze takové akce a v takových organizacích, které jsou povoleny osobě, jež je vytvořila. Odkaz pro sdílení vytvořený asistentem je omezen stejným způsobem: nemůže udělit roli, kterou autorizující člověk sám nedisponuje.