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