Upravljajte pločama putem API-ja ili pomoću AI asistenta

Pločama se može u potpunosti upravljati izvan nadzorne ploče. Dvije rute, jedan model dozvola i isto ponašanje kao na zaslonima — jer pozivaju isti kôd.

REST API

Svaka se operacija nalazi u našoj javnoj OpenAPI specifikaciji, s generiranim klijentima u jezicima TypeScript, Python, PHP i Go, a CLI se generira iz iste specifikacije. Ploče, stupci, kartice, komentari, pitanja, oznake, članovi i veze za dijeljenje u potpunosti su pokriveni.

Krajnje točke koje ćete najčešće koristiti:

• GET /v1/agency/boards — vaše ploče
• GET /v1/agency/boards/{id} — jedna ploča s pripadajućim stupcima i karticama
• POST /v1/agency/boards/{id}/cards — dodavanje zadatka
• POST /v1/agency/boards/{id}/cards/{id}/move — premještanje zadatka
• POST /v1/agency/boards/{id}/invites — stvaranje veze za dijeljenje

Token veze za dijeljenje vraća se pri tom posljednjem pozivu i samo pri tom pozivu. Pohranjujemo njegov digitalni otisak, stoga ne postoji krajnja točka koja ga može ponovno pročitati — ako vaša skripta treba vezu, sačuvajte je iz odgovora.

MCP poslužitelj

Ako upotrebljavate AI asistenta koji podržava MCP, povežite ga i izravno će dobiti alate za ploče: popis ploča, potpuno čitanje pojedine ploče, stvaranje ploče, dodavanje kartice, premještanje kartice, komentiranje, stvaranje veze za dijeljenje i njezino opozivanje. To pretvara upit „sažmi ovaj tjedan i pošalji vezu klijentu Acme” u jednu uputu umjesto upotrebe dvaju sustava i kopiranja i lijepljenja.

Dvije stvari koje vrijedi znati o alatima:

• Nova kartica je interna osim ako ne navedete drukčije. Asistent koji sažima vaš interni rad ne smije objaviti taj sažetak vašem klijentu samo zato što nitko nije rekao da to ne učini, stoga je visibility prema zadanim postavkama postavljena na interno i mora se namjerno postaviti na client.
• Opoziv veze zahtijeva potvrdu, jer ujedno uklanja svakoga tko se pridružio putem te veze — a alat vam govori koliko je to točno ljudi bilo, umjesto da samo prijavi uspješno izvršenje.

Što je potrebno

Pristup za API i MCP uključen je u paket Boards Business i u svaki Agency hosting paket. Na paketima Boards Free i Boards Pro krajnje točke ploča odgovaraju porukom u kojoj se to navodi.

API ključ ili MCP veza mogu činiti samo ono što može činiti osoba koja ih je stvorila, u organizacijama u kojima ona to može činiti. Veza za dijeljenje koju stvori asistent ograničena je na isti način: ne može dodijeliti ulogu koju sam korisnik koji daje ovlaštenje ne posjeduje.