ניהול לוחות מתוך ה-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, חברו אותו והוא מקבל כלים לניהול לוחות ישירות: הצגת רשימת לוחות, קריאת לוח במלואו, יצירת לוח, הוספת כרטיס, העברת כרטיס, הוספת תגובה, יצירת קישור שיתוף וביטולו. הדבר הופך את הבקשה "סכם את השבוע הזה ושלח לאקמה קישור" להוראה אחת במקום שני מערכות והעתקה-הדבקה.

שני דברים שכדאי לדעת על הכלים:

• כרטיס חדש הוא פנימי אלא אם צוין אחרת. עוזר המסכם את העבודה הפנימית שלכם אסור לו לפרסם את הסיכום הזה ללקוח שלכם רק מפני שאף אחד לא אמר לו לא לעשות זאת, ולכן הפרמטר visibility מוגדר כברירת מחדל לפנימי ויש להגדירו במתכוון כ-client.
• ביטול קישור דורש אישור, מכיוון שהוא מסיר גם את כל מי שהצטרף דרך הקישור הזה – והכלי מדווח לכם מה היה מספר האנשים הללו, במקום לדווח על הצלחה סתמית.

מה נדרש לשם כך

גישת API ו-MCP כלולה בתוכנית Boards Business ובכל תוכנית אירוח של Agency. בתוכניות Boards Free ו-Boards Pro נקודות הקצה של הלוחות משיבות בהודעה המציינת זאת.

מפתח API או חיבור MCP יכולים לבצע אך ורק את מה שהאדם שיצר אותם מורשה לעשות, בארגונים שבהם יש לו הרשאה לכך. קישור שיתוף שעוזר יוצר כפוף לאותם גבולות: הוא אינו יכול להעניק תפקיד שהאדם המאשר אינו מחזיק בו בעצמו.