للمطورين

ابنِ على Onplana

اقرأ المشاريع والمهام وعدّلها من شيفرتك، واعرف بالتغييرات لحظة حدوثها، وانقل الخطة إلى تقاريرك، ودع وكلاء الذكاء الاصطناعي يعملون عليها. خمسة مداخل، لكل منها رمز يتصرف بصفة الشخص الذي أنشأه.

خمسة مداخل

جميعها تعمل اليوم. ابدأ بالمثال ثم اتبع دليله.

REST API برموز وصول شخصية

أنشئ رمزًا من الإعدادات ثم المطور، بالصلاحيات والمشاريع التي تحتاج إليها فقط، وبتاريخ انتهاء. يتصرف بصفتك، في مؤسسة واحدة، ولا يمكنه أبدًا أن يفعل أكثر مما تستطيعه أنت. تصف مواصفة OpenAPI 3.1 كل مسار.

جميع الخطط، بما فيها الخطة المجانية

مهامك المفتوحة في جميع المشاريع
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Webhooks موقّعة

يرسل Onplana بطلب POST حمولة JSON إلى عنوان URL الخاص بك عند وقوع أي من أنواع الأحداث البالغ عددها 22. يحمل كل تسليم توقيع HMAC-SHA256 للمحتوى مصنوعًا بسرّك، وتبقى كل محاولة في سجل التسليمات.

بدءًا من خطة Business

اعرف متى تتغير حالة مهمة
curl -X POST https://api.onplana.com/api/webhooks \
  -H "Authorization: Bearer pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Status changes","url":"https://example.com/onplana","events":["task.status_changed"],"secret":"YOUR_SECRET"}'

موجز تقارير OData

موجز OData v4 للقراءة فقط يضم المشاريع والمهام والإسنادات والموارد وأسطر سجلات الوقت وقيم الحقول المخصصة وخطوط الأساس. يصل إليه Power BI أو Excel أو مستودع بياناتك برمز يملك صلاحية التقارير.

بدءًا من خطة Professional

قراءة خمس مهام من الموجز
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

خادم MCP لوكلاء الذكاء الاصطناعي

يستطيع Claude وChatGPT وCursor وأي عميل MCP آخر قراءة العمل وإدارته بصلاحيات الشخص الذي يربطه. يسجّل العملاء الدخول في المتصفح، فلا تطبيق يجب تسجيله مسبقًا.

جميع الخطط، بما فيها الخطة المجانية. يزداد عدد الوكلاء المتصلين في الوقت نفسه مع الخطة.

إضافة Onplana إلى عميل MCP
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

الموصلات

قبل أن تبني، تحقق مما إذا كان الربط موجودًا بالفعل. يسجّل كل موصل الدخول برمز وصول شخصي، ويُجري التحقق نفسه أولًا.

  • Microsoft Teams وMicrosoft 365 Copilot: متاحان في جميع الخطط، بما فيها الخطة المجانية.
  • روابط ملفات SharePoint وOneDrive في المهام: متاحة بدءًا من خطة Professional.
  • Power Automate وPower Apps: الموصل مبني على API نفسها ولم يُنشر بعد.
  • Zapier: التطبيق مبني على API نفسها ولم يُنشر بعد.

تشترك مشغّلات الموصل في Webhook: بدءًا من خطة Business.

التحقق من اتصال موصل
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

كيف يعمل الطلب

  • أرسل الرمز كرمز Bearer. الرمز مرتبط بالمؤسسة التي أُنشئ فيها، فلا يحتاج الطلب إلى ترويسة مؤسسة.
  • تعود الأخطاء بصيغة JSON مع جملة يمكنك عرضها، ورمز، وrequestId تذكره حين تراسل الدعم.
  • الحدود مضبوطة لكل عائلة من المسارات. الطلب المرفوض يرد بالرمز 429 مع ترويسة Retry-After بالثواني: انتظر تلك المدة ثم أعد المحاولة.
  • المواصفة على api.onplana.com/api/openapi.json، فيمكنك توليد عميل بأي لغة انطلاقًا منها.

أي خطة يحتاج إليها كل مدخل

مقروءة من جدول الأسعار، فتتطابق هذه القائمة وصفحة الأسعار دائمًا.

ما الذي يستخدمهالخطة
REST API ورموز الوصول الشخصيةجميع الخطط، بما فيها الخطة المجانية
Webhooksبدءًا من خطة Business
موجز تقارير ODataبدءًا من خطة Professional
خادم MCPجميع الخطط، بما فيها الخطة المجانية
تطبيق Microsoft Teams ووكيل Copilotجميع الخطط، بما فيها الخطة المجانية
روابط ملفات SharePoint وOneDriveبدءًا من خطة Professional
مشغّلات الموصلات (تشترك في Webhook)بدءًا من خطة Business

ما يسأل عنه المطورون

هل توجد SDK؟

لا. API عبارة عن JSON عبر HTTPS مع مواصفة OpenAPI 3.1، فيصلح أي عميل HTTP، ويمكنك توليد عميل بأنواع محددة من المواصفة.

هل تُدفع API بشكل منفصل؟

لا. REST API والرموز متاحة في جميع الخطط، بما فيها الخطة المجانية. وWebhooks متاحة بدءًا من خطة Business، وموجز OData بدءًا من خطة Professional.

هل يمكن لتطبيق الخادم لدي التصرف نيابة عن عملاء كثيرين؟

ليس عبر OAuth بعد. اليوم ينشئ كل عميل رمزًا لتكامله، ويتصرف الرمز بصفة الشخص الذي أنشأه. وإن احتاج منتجك إلى غير ذلك، فأخبرنا بما تحتاج إليه.

أين شروط استخدام API؟

تشرح صفحة شروط API، في وثائق المطورين، الاستخدام المقبول، وما يمثله الرمز، وكيف يُعلن عن التغييرات غير المتوافقة.

أنشئ رمزك الأول

سجّل مجانًا، وافتح الإعدادات ثم المطور، وأنشئ رمزًا بالصلاحيات التي تحتاج إليها شيفرتك.