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

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

رابط برنامه‌نویسی REST

هر عملیات در مشخصات عمومی OpenAPI ما قرار دارد، با کلاینت‌های تولیدشده در TypeScript، پایتون، PHP و Go، و رابط خط فرمان (CLI) نیز از روی همین مشخصات تولید شده است. بوردها، ستون‌ها، کارت‌ها، نظرات، پرسش‌ها، برچسب‌ها، اعضا و لینک‌های اشتراک‌گذاری همگی پوشش داده شده‌اند.

پرکاربردترین نقاط پایانی (Endpoints) که استفاده خواهید کرد:

• 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 — تولید یک لینک اشتراک‌گذاری

توکن لینک اشتراک‌گذاری در همان فراخوانی آخر و فقط در همان فراخوانی برمی‌گردد. ما اثر انگشت (Fingerprint) آن را ذخیره می‌کنیم، بنابراین هیچ نقطه پایانی وجود ندارد که بتواند آن را دوباره بخواند — اگر اسکریپت شما به لینک نیاز دارد، آن را از پاسخِ دریافتی نگه دارید.

سرور MCP

اگر از دستیار هوش مصنوعی استفاده می‌کنید که از MCP پشتیبانی می‌کند، آن را متصل کنید تا ابزارهای بورد را به‌طور مستقیم دریافت کند: فهرست کردن بوردها، خواندن کامل یک بورد، ایجاد بورد، افزودن کارت، جابه‌جایی کارت، ثبت نظر، ایجاد لینک اشتراک‌گذاری و ابطال آن. این کار، عبارت "این هفته را خلاصه کن و یک لینک برای Acme بفرست" را به یک دستورِ واحد تبدیل می‌کند، به‌جای کار با دو سیستم و کپی‌پیست کردن.

دو نکته که ارزش دارد درباره ابزارها بدانید:

• یک کارت جدید تا زمانی که خلاف آن را نگویید، داخلی است. دستیاری که کار داخلی شما را خلاصه می‌کند نباید آن خلاصه را برای مشتری شما منتشر کند، چرا که کسی نگفته این کار را نکند؛ بنابراین visibility به‌طور پیش‌فرض روی حالت داخلی تنظیم می‌شود و باید به‌طور عمدی روی client قرار گیرد.
• ابطال یک لینک نیاز به تأیید دارد، زیرا هر کسی را که از طریق آن لینک ملحق شده است نیز حذف می‌کند — و ابزار به‌جای گزارش یک موفقیتِ ساده، به شما می‌گوید که تعداد آن افراد چقدر بوده است.

ملزومات

دسترسی به API و MCP در طرح Boards Business و در تمامی طرح‌های میزبانی Agency گنجانده شده است. در طرح‌های Boards Free و Boards Pro، نقاط پایانی بورد با پیامی که این موضوع را اعلام می‌کند پاسخ می‌دهند.

یک کلید API یا اتصال MCP فقط می‌تواند کارهایی را انجام دهد که شخصِ ایجادکننده‌ی آن مجاز به انجامشان است، آن هم در سازمان‌هایی که دسترسی دارد. لینک اشتراک‌گذاری که یک دستیار ایجاد می‌کند نیز به همین صورت محدود می‌شود: این لینک نمی‌تواند نقشی را اعطا کند که انسانِ مجازکننده‌ی آن، خودش در اختیار ندارد.