Тақталарды API немесе AI көмекшісі арқылы басқарыңыз

Тақталарды басқару панелінің сыртынан толықтай басқаруға болады. Екі бағыт, бір рұқсаттар моделі және интерфейс экранымен бірдей әрекет — себебі олар бірдей кодты шақырады.

REST API

Әрбір операция біздің ашық OpenAPI спецификациямызда қамтылған, TypeScript, Python, PHP және Go тілдерінде жасалған клиенттері бар, ал CLI сол спецификация негізінде жасалған. Тақталар, бағандар, карточкалар, түсініктемелер, сұрақтар, белгілер, қатысушылар және бөлісу сілтемелері түгелдей қамтылған.

Сіз ең жиі қолданатын соңғы нүктелер:

• GET /v1/agency/boards — тақталарыңыз
• GET /v1/agency/boards/{id} — бағандары мен карточкалары бар бір тақта
• POST /v1/agency/boards/{id}/cards — тапсырма қосу
• POST /v1/agency/boards/{id}/cards/{id}/move — оны жылжыту
• POST /v1/agency/boards/{id}/invites — бөлісу сілтемесін жасау

Бөлісу сілтемесінің токені осы соңғы шақыру кезінде және тек сол шақыру кезінде ғана қайтарылады. Біз оның сандық таңбасын ғана сақтаймыз, сондықтан оны қайта оқи алатын ешқандай соңғы нүкте жоқ — егер сценарийіңізге сілтеме қажет болса, оны жауаптан сақтап алыңыз.

MCP сервері

Егер сіз MCP қолдайтын AI көмекшісін пайдалансаңыз, оны қосыңыз және ол тақта құралдарына тікелей қол жеткізеді: тақталарды тізімдеу, біреуін толық оқу, тақта жасау, карточка қосу, карточканы жылжыту, пікір қалдыру, бөлісу сілтемесін жасау және оның күшін жою. Бұл екі жүйе мен көшіріп-қоюдың орнына «осы аптаны қорытындылап, Acme-ге сілтеме жібер» дегенді бір ғана нұсқаулыққа айналдырады.

Құралдар туралы білуге тұрарлық екі жайт:

• Басқаша көрсетілмесе, жаңа карточка ішкі болып табылады. Ішкі жұмысыңызды қорытындылайтын көмекші ешкім қарсы болмағаны үшін ғана бұл қорытындыны клиентіңізге жарияламауы керек, сондықтан visibility әдепкі бойынша ішкі болып орнатылады және оны client күйіне арнайы өзгерту қажет.
• Сілтенің күшін жою растауды талап етеді, өйткені ол сол сілтеме арқылы қосылған кез келген адамды да жояды — және құрал жай ғана сәтті орындалғанын хабарлаудың орнына, бұл қанша адам екенін көрсетеді.

Не қажет

API және MCP қатынасы Boards Business және әрбір Agency хостинг тарифтік жоспарына қосылған. Boards Free және Boards Pro тарифтерінде тақтаның соңғы нүктелері осыны білдіретін хабарламамен жауап береді.

API кілті немесе MCP қосылымы оны жасаған тұлғаның өз ұйымдарындағы рұқсат етілген әрекеттерін ғана орындай алады. Көмекші жасаған бөлісу сілтемесі де дәл осылай шектеледі: ол рұқсат беруші адамның өзінде жоқ рөлді бере алмайды.