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 тілінде сөйлейтін жасанды интеллект көмекшісін қолдансаңыз, оны қосыңыз, сонда ол тақта құралдарын тікелей алады: тақталар тізімін көру, біреуін толық оқу, тақта жасау, карта қосу, картаны жылжыту, пікір жазу, бөлісу сілтемесін жасау және оның күшін жою. Бұл «осы аптаның қорытындысын шығарып, Acme компаниясына сілтеме жіберу» әрекетін екі жүйе мен көшіріп-қоюдың орнына бір нұсқауға айналдырады.

Құралдар туралы білуге ​​тұратын екі нәрсе:

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

Оған не қажет

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

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