Irányítsa a táblákat az API-ból vagy egy MI-asszisztensből

A táblák teljes mértékben vezérelhetők az irányítópulton kívülről is. Két útvonal, egyetlen jogosultsági modell, és a képernyőkkel megegyező működés — mivel ugyanazt a kódot hívják meg.

A REST API

Minden művelet megtalálható a nyilvános OpenAPI-specifikációnkban, generált TypeScript-, Python-, PHP- és Go-kliensekkel, és a CLI is 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 lefedettek.

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 — feladat hozzáadása
• POST /v1/agency/boards/{id}/cards/{id}/move — feladat mozgatása
• POST /v1/agency/boards/{id}/invites — megosztási hivatkozás létrehozása

A megosztási hivatkozás tokenje ennél az utolsó hívásnál érkezik vissza, és kizárólag ennél a hívásnál. Ennek csak az ujjlenyomatát tároljuk, így nincs olyan végpont, amely újra ki tudná olvasni — ha a szkriptjének szüksége van a hivatkozásra, mentse el a válaszból.

Az MCP-kiszolgáló

Ha olyan AI-asszisztenst használ, amely támogatja az MCP-t, csatlakoztassa, és közvetlenül hozzáfér a táblaeszközökhöz: táblák listázása, egy tábla teljes beolvasása, tábla létrehozása, kártya hozzáadása, kártya mozgatása, hozzászólás, megosztási hivatkozás létrehozása és visszavonása. Ez a „foglald össze ezt a hetet, és küldj egy hivatkozást az Acme-nak” kérést egyetlen utasítássá alakítja két külön rendszer és a másolás-beillesztés helyett.

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

• Az új kártya belső, hacsak nem rendelkezik másként. A belső munkáját összegző asszisztens nem teheti közzé ezt az összefoglalót az ügyfelének pusztán azért, mert senki sem mondta, hogy ne tegye, így a visibility alapértelmezés szerint belsőre van állítva, és kifejezetten client értékre kell módosítani.
• A hivatkozás visszavonása megerősítést kér, mivel eltávolít mindenkit, aki ezen a hivatkozáson keresztül csatlakozott — és az eszköz a puszta sikeres állapot jelentése helyett közli Önnel, hogy ez hány személyt érintett.

Rendszerkövetelmények

Az API- és MCP-hozzáférést a Boards Business és minden Agency tárhelycsomag tartalmazza. A Boards Free és Boards Pro csomagok esetében a táblavégpontok egy ezt jelző üzenettel válaszolnak.

Egy API-kulcs vagy MCP-kapcsolat csak azt teheti meg, amit az azt létrehozó személy tehet azokban a szervezetekben, amelyekben erre jogosult. Az asszisztens által létrehozott megosztási hivatkozás ugyanígy korlátozott: nem oszthat ki olyan szerepkört, amellyel a hitelesítő személy maga sem rendelkezik.