قاعدة المعرفة
أدر اللوحات من واجهة برمجة التطبيقات (API) أو من مساعد الذكاء الاصطناعي
تتوفر كل عملية لوحة في واجهة برمجة التطبيقات العامة الخاصة بنا وكأداة MCP، بحيث يمكن لبرنامج نصي أو وكيل ذكاء اصطناعي قراءة اللوحة وإضافة العمل وإرسال رابط إلى العميل.
لوحات التحكم قابلة للتشغيل بالكامل من خارج لوحة التحكم الرئيسية. مساران، ونموذج صلاحيات واحد، ونفس سلوك الشاشات - لأنها تستدعي نفس الكود.
واجهة برمجة تطبيقات REST
كل عملية مدرجة في مواصفات 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— إنشاء رابط مشاركة
يتم إرجاع رمز (token) رابط المشاركة في هذا الاستدعاء الأخير فقط ولا يتم إرجاعه في أي استدعاء آخر. نحن نخزن بصمة له، لذلك لا توجد نقطة نهاية يمكنها قراءته مرة أخرى — إذا كان البرنامج النصي الخاص بك بحاجة إلى الرابط، فاحفظه من الاستجابة.
خادم MCP
إذا كنت تستخدم مساعداً ذكياً يدعم بروتوكول MCP، فقم بتوصيله ليحصل على أدوات اللوحات مباشرة: سرد اللوحات، وقراءة لوحة بالكامل، وإنشاء لوحة، وإضافة بطاقة، ونقل بطاقة، والتعليق، وإنشاء رابط مشاركة وإلغاؤه. هذا يحول عبارة "تلخيص هذا الأسبوع وإرسال رابط إلى Acme" إلى تعليمة واحدة بدلاً من استخدام نظامين والنسخ واللصق.
أمران يجدر معرفتهما حول الأدوات:
- تعتبر البطاقة الجديدة داخلية ما لم ترتأِ خلاف ذلك. يجب ألا يقوم المساعد الذي يلخص عملك الداخلي بنشر هذا الملخص لعميلك لمجرد عدم وجود توجيه بعدم القيام بذلك، لذا فإن قيمة
Visibilityتعود افتراضياً إلى داخلية ويجب تعيينها إلىclientبشكل متعمد. - يتطلب إلغاء الرابط تأكيداً، لأنه يؤدي أيضاً إلى إزالة أي شخص انضم عبر هذا الرابط — وتخبرك الأداة بعدد هؤلاء الأشخاص، بدلاً من الإبلاغ عن نجاح عادي.
ما يتطلبه الأمر
تم تضمين الوصول إلى واجهة برمجة التطبيقات (API) وخادم (MCP) في خطة Boards Business وفي كل خطة استضافة لـ Agency. في خطط Boards Free و Boards Pro، ترد نقاط نهاية اللوحات برسالة توضح ذلك.
لا يمكن لمفتاح واجهة برمجة التطبيقات أو اتصال MCP إلا القيام بما يستطيع الشخص الذي أنشأه القيام به، وفي المؤسسات التي يُسمح له بالعمل فيها. وينطبق نفس القيد على رابط المشاركة الذي ينشئه المساعد: فهو لا يمكنه منح دور لا يمتلكه الشخص البشري المصرح في الأساس.