بردها را از طریق API یا با استفاده از یک دستیار هوش مصنوعی هدایت کنید

بردها به طور کامل از خارج از داشبورد قابل هدایت هستند. دو مسیر، یک مدل مجوز، و همان رفتار صفحات نمایش — زیرا آن‌ها همان کد را فراخوانی می‌کنند.

وب‌سرویس 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 فقط می‌تواند کارهایی را انجام دهد که شخص ایجادکننده آن مجاز به انجامشان است، آن هم در سازمان‌هایی که اجازه آن را دارد. پیوند اشتراک‌گذاری که یک دستیار ایجاد می‌کند نیز به همین ترتیب محدود است: نمی‌تواند نقشی را اعطا کند که خودِ انسان تأییدکننده فاقد آن است.