قم بإدارة اللوحات عبر واجهة برمجة التطبيقات (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 سوى القيام بما يملك الشخص الذي أنشأه صلاحية فعله، وفي المؤسسات التي يحق له العمل فيها فقط. كما يتم تقييد رابط المشاركة الذي ينشئه المساعد بنفس الطريقة: لا يمكنه منح دور لا يمتلكه الشخص المفوض بنفسه.