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

Pločama se u potpunosti može upravljati izvan nadzorne ploče. Dvije rute, jedan model dozvola i isto ponašanje kao i kod zaslona — budući da pozivaju isti kod.

REST API

Svaka je operacija obuhvaćena našom javnom OpenAPI specifikacijom, s generiranim klijentima za TypeScript, Python, PHP i Go, a CLI se generira iz iste specifikacije. Obuhvaćene su ploče, stupci, kartice, komentari, pitanja, oznake, članovi i poveznice za dijeljenje.

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 — dodajte radni zadatak
• POST /v1/agency/boards/{id}/cards/{id}/move — premjestite ga
• POST /v1/agency/boards/{id}/invites — izradite poveznicu za dijeljenje

Token poveznice za dijeljenje vraća se u tom posljednjem pozivu i isključivo u tom pozivu. Pohranjujemo njegov otisak, stoga ne postoji krajnja točka koja ga može ponovno pročitati — ako vaša skripta treba poveznicu, spremite je iz odgovora.

MCP poslužitelj

Ako koristite AI pomoćnika koji podržava MCP, povežite ga i on izravno dobiva alate za ploče: popis ploča, čitanje jedne u cijelosti, stvaranje ploče, dodavanje kartice, premještanje kartice, komentar, stvaranje poveznice za dijeljenje i opoziv iste. Time se radnja "sažmi ovaj tjedan i pošalji Acmi poveznicu" pretvara u jednu instrukciju umjesto dva sustava i kopiranja i lijepljenja.

Dvije stvari koje je korisno znati o alatima:

• Nova je kartica interna osim ako izričito ne navedete drugačije. Pomoćnik koji sažima vaš interni rad ne smije taj sažetak objaviti klijentu samo zato što nitko nije rekao suprotno, stoga visibility zadano ima vrijednost interna i mora se namjerno postaviti na client.
• Opoziv poveznice traži potvrdu, jer se time ujedno uklanjaju sve osobe koje su se pridružile putem te poveznice — a alat vam javlja o koliko se točno ljudi radilo, umjesto da samo javi uredan uspjeh.

Što je potrebno

API i MCP pristup uključeni su u paket Boards Business i u svaki paket hostinga za agencije. Na paketima Boards Free i Boards Pro krajnje točke za ploče odgovaraju porukom koja to objašnjava.

API ključ ili MCP veza mogu učiniti samo ono što može učiniti osoba koja ih je izradila, unutar organizacija u kojima ima ta ovlaštenja. Poveznica za dijeljenje koju pomoćnik stvori ograničena je na isti način: ne može dodijeliti ulogu koju autorizirajuća osoba sama ne posjeduje.