Vezérelje a táblákat az API-ról vagy egy AI-asszisztens segítségével

A táblák a vezérlőpulton kívülről is teljes körűen irányíthatók. Két útvonal, egy engedélymodell és a képernyőkkel azonos viselkedés – mivel ugyanazt a kódot hívják meg.

A REST API

Minden művelet szerepel a nyilvános OpenAPI-specifikációnkban, a TypeScript, Python, PHP és Go nyelveken generált kliensekkel, a CLI pedig ugyanebből a specifikációból készül. A táblák, oszlopok, kártyák, hozzászólások, kérdések, címkék, tagok és megosztási hivatkozások mind le vannak fedve.

A leggyakrabban használt végpontok:

• GET /v1/agency/boards – az Ön táblái
• GET /v1/agency/boards/{id} – egy tábla az oszlopaival és kártyáival
• POST /v1/agency/boards/{id}/cards – munka hozzáadása
• POST /v1/agency/boards/{id}/cards/{id}/move – áthelyezés
• POST /v1/agency/boards/{id}/invites – megosztási hivatkozás létrehozása

A megosztási hivatkozás tokenje az utolsó hívás válaszában érkezik meg, és kizárólag abban. Ennek egy ujjlenyomatát tároljuk, így nincs olyan végpont, amely le tudná olvasni – ha a parancsfájlnak szüksége van a hivatkozásra, mentse el azt a válaszból.

Az MCP-szerver

Ha olyan mesterségesintelligencia-asszisztenst használ, amely ismeri az MCP-t, csatlakoztassa, és az közvetlenül megkapja a táblaeszközöket: táblák listázása, egy tábla teljes beolvasása, tábla létrehozása, kártya hozzáadása, kártya áthelyezése, hozzászólás, megosztási hivatkozás létrehozása és visszavonása. Ezzel a „gezze össze ezen a héten a történteket, és küldjön az Acmenak egy hivatkozást” feladat egyetlen utasítássá válik két különböző rendszer és a másolás-beillesztés helyett.

Két dolog, amit érdemes tudni az eszközökről:

• Az új kártyák alapértelmezés szerint belső jellegűek, hacsak másként nem rendelkezik. A belső munkáját összegző asszisztens nem teheti közzé ezt az összefoglalót az ügyfele számára pusztán azért, mert senki sem mondta neki az ellenkezőjét, ezért a visibility paraméter alapértelmezés szerint belső (internal) értékre van állítva, és szándékosan kell ügyfél (client) értékre módosítani.
• A hivatkozás visszavonása megerősítést kér, mivel az eltávolít mindenkit is, aki ezen a hivatkozáson keresztül csatlakozott – az eszköz pedig a rendezett sikeres visszajelzés helyett azt is megmutatja, hogy hány embert érintett ez.

Mire van szükség

Az API- és MCP-hozzáférés a Boards Business csomagban és minden Agency tárhelycsomagban benne van. A Boards Free és Boards Pro csomagokban a táblák végpontjai erre utaló üzenettel válaszolnak.

Egy API-kulcs vagy MCP-kapcsolat csak azt tudja megtenni, amit a létrehozója, azokban a szervezetekben, amelyekben erre jogosult. Az asszisztens által létrehozott megosztási hivatkozásra ugyanezek a korlátozások vonatkoznak: nem adhat olyan szerepkört, amellyel a felhatalmazást adó személy maga sem rendelkezik.