الوثائق
REST API: البدء السريع والمرجع
المصادقة بمفتاح API، وحدود المعدّل، والتقسيم إلى صفحات، ومرجع OpenAPI 3.1.
الأتمتة والمطوّرون
REST API لقراءة الخطط وكتابتها
المشاريع والمهام والإسنادات والتبعيات عبر REST API، مع مفاتيح API محدّدة النطاق ومرجع OpenAPI 3.1.
- متاح
- مجاني، مشمول في كل حساب
ماذا يفعل
خطافات الويب وREST API لأتمتتك الخاصة
لكل ما ليس له تكامل جاهز: حدث موقّع بمجرد حدوث تغيير، وواجهة API لقراءة الخطة وكتابتها.
حيث يفيد
- اربط Planitude بنظام داخلي أو ERP أو مستودع بيانات.
- شغّل أتمتة بمجرد إكمال مهمة أو نقلها.
- أنشئ المشاريع والمهام من أداة أخرى دون نسخها يدويًا.
من Planitude إلى نظامك
- كل تغيير، من تطبيق الويب أو API أو MCP أو عملية استيراد → أحداث موقّعة, من Planitude إلى نظامك
في الاتجاهين
- المشاريع والمهام والإسنادات والتبعيات ↔ قراءة وكتابة عبر REST API, في الاتجاهين
الإعداد
اربطه في ثلاث خطوات
أنشئ مفتاح API
في الملف الشخصي ← مفاتيح API، للقراءة فقط أو للقراءة والكتابة، ويمكن تقييده بمساحة عمل واحدة وبتاريخ انتهاء.
سجّل خطاف ويب
على مشروع واحد أو على مساحة عمل كاملة، مع الاختيار من بين 14 أحداث: إنشاء المهام أو إكمالها أو نقلها، والتبعيات، وخطوط الأساس، والتعليقات، وغيرها.
استقبل واستدعِ
تحقق من توقيع HMAC-SHA256 لكل حدث واستدعِ REST API الموثّقة بمواصفة OpenAPI 3.1.
المتطلبات
- الخطة
- مجانية. كل تكامل مشمول في كل حساب Planitude.
- من يستطيع ربطه
- كل مستخدم، بمفتاح API الخاص به. خطافات المشروع: المالك أو المحرر؛ وخطافات مساحة العمل: المالك أو المسؤول.
- ما تحتاجه
- نقطة نهاية HTTPS عامة لاستقبال خطافات الويب؛ وبالنسبة إلى API، مفتاح يُنشأ من الملف الشخصي ← مفاتيح API.
من المفيد أن تعرف
- Zapier وMake وn8n قادمة قريبًا وستستخدم واجهة API وخطافات الويب نفسها.
- لا يمكن للمفاتيح والتطبيقات المتصلة حذف المشاريع أو المهام: يبقى الحذف في تطبيق الويب.
الأدلة والوثائق
الوثائق
خطافات الويب: الأحداث والتواقيع وإعادة المحاولة
كتالوج الأحداث، والتحقق من توقيع HMAC-SHA256، والتسليم مع إعادة المحاولة.
دليل
الأدوات التي يمكن ربطها بـ Planitude: دليل التكاملات
تكاملات Planitude: Jira وAzure DevOps وSlack وTeams والتقويمات وChatGPT وClaude وGemini عبر MCP وAPI وwebhooks وملفات .mpp و.xer. أيها تختار.
الأسئلة الشائعة حول REST API
كيف أتحقق من أن خطاف الويب يأتي فعلًا من Planitude؟
يحمل كل طلب ترويسة بطابع زمني وتوقيع HMAC-SHA256 للنص: أعد حسابه بسرّ خطاف الويب وارفض الطلبات القديمة جدًا. وتتضمن وثائق المطوّرين أمثلة جاهزة.
هل يمكن لتكامل API حذف المشاريع؟
لا. يمكن لمفاتيح API والتطبيقات المتصلة القراءة، وبصلاحية الكتابة الإنشاء والتحديث، لكن حذف المشاريع والمهام يبقى في تطبيق الويب.
هل للتكاملات تكلفة؟
لا. كل تكامل مشمول في Planitude المجاني. كل ما تحتاجه هو وصولك الخاص إلى الأداة الأخرى (مثل حساب Jira أو Slack أو Microsoft 365) وفق شروطها.
كيف أقطع اتصال تكامل؟
من صفحة التطبيق في المشروع، عبر «قطع الاتصال»، في أي وقت. لا يُحذف شيء: تبقى المهام في Planitude، وتبقى المسائل والرسائل في الأداة الأخرى. وتُلغى تطبيقات الذكاء الاصطناعي المتصلة من الملف الشخصي ← مفاتيح API.
العلامات التجارية المذكورة (Jira وAzure DevOps وSlack وMicrosoft Teams وMicrosoft Outlook وMicrosoft PowerPoint وMicrosoft Project وVisual Studio Code وGoogle Calendar وGemini وApple Calendar وChatGPT وCodex وClaude وCursor وZapier وMake وn8n وPrimavera) مملوكة لأصحابها؛ وPlanitude غير تابع لهم ولا مؤيَّد منهم.