Baza znanja

Upravljajte tablama preko API-ja ili pomoću AI asistenta

Svaka operacija nad tablom je u našem javnom API-ju i dostupna je kao MCP alat, tako da skripta ili AI agent mogu da pročitaju tablu, dodaju posao i pošalju klijentu link.

Table se mogu u potpunosti koristiti izvan kontrolne table. Dve rute, jedan model dozvola i isto ponašanje kao kod ekrana — zato što pozivaju isti kod.

REST API

Svaka operacija je u našoj javnoj OpenAPI specifikaciji, sa generisanim klijentima za TypeScript, Python, PHP i Go, a CLI je generisan iz iste specifikacije. Table, kolone, kartice, komentari, pitanja, oznake, članovi i linkovi za deljenje su obuhvaćeni.

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

  • GET /v1/agency/boards — vaše table
  • GET /v1/agency/boards/{id} — jedna tabla sa svojim kolonama i karticama
  • POST /v1/agency/boards/{id}/cards — dodajte rad
  • POST /v1/agency/boards/{id}/cards/{id}/move — premestite ga
  • POST /v1/agency/boards/{id}/invites — kreirajte link za deljenje

Token linka za deljenje se vraća u tom poslednjem pozivu i isključivo u tom pozivu. Čuvamo njegov otisak prsta, tako da ne postoji krajnja tačka koja može ponovo da ga pročita — ako je vašem skriptu potreban link, sačuvajte ga iz odgovora.

MCP server

Ako koristite AI asistenta koji govori MCP, povežite ga i on direktno dobija alatke za table: izlistavanje tabla, čitanje jedne u potpunosti, kreiranje table, dodavanje kartice, premeštanje kartice, komentarisanje, kreiranje linka za deljenje i opoziv istog. To pretvara "sumiraj ovu nedelju i pošalji link za Acme" u jednu instrukciju umesto dva sistema i kopiranja i lepljenja.

Dve stvari koje je vredno znati o alatkama:

  • Nova kartica je interna osim ako ne navedete drugačije. Asistent koji sumira vaš interni rad ne sme da objavi taj rezime vašem klijentu samo zato što niko nije rekao da se to ne radi, pa je visibility podrazumevano podešen na interni i mora se svesno postaviti na client.
  • Opoziv linka zahteva potvrdu, zato što takođe uklanja sve koji su se pridružili preko tog linka — i alatka vam govori koliko je to ljudi bilo, umesto da prijavi uredan uspeh.

Šta je potrebno

API i MCP pristup su uključeni u Boards Business i u svaki Agency plan hostinga. Na paketima Boards Free i Boards Pro krajnje tačke za table odgovaraju porukom koja to objašnjava.

API ključ ili MCP veza mogu da urade samo ono što osoba koja ih je kreirala može da uradi, u organizacijama u kojima to može. Link za deljenje koji asistent kreira ograničen je na isti način: ne može dodeliti ulogu koju autorizujuća osoba sama ne poseduje.

Još uvek ste zaglavljeni?

Podrška je uključena u svaki paket, a odgovori stižu na vašem jeziku.

Kontaktirajte podršku Svi članci