عامة وبلا مصادقة

توثيق المطوّرين

يوفّر Matin PPM 360 واجهة REST مفتوحة في كل باقة مدفوعة. اربط أنظمة تخطيط الموارد وذكاء الأعمال وأدوات الأتمتة بالبيانات المحوكمة نفسها التي تستخدمها فرق التنفيذ. ولا يتطلب أي شيء في هذه الصفحة تسجيل الدخول.

مواصفة OpenAPI اطرح سؤالًا عن التكامل

أربعة أمور ينبغي معرفتها

المصادقة

أصدر مفتاح واجهة برمجية محدود الصلاحية من قسم API Access داخل مساحة عملك، وأرسله كرمز حامل. المفاتيح محصورة بالمستأجر، ومخزّنة مُجزّأة، وقابلة للإلغاء في أي وقت.

الموارد

المحافظ والبرامج والمشاريع والمهام والمخاطر والمشكلات والمعالم والجداول الزمنية والموافقات متاحة كمجموعات REST مع الترشيح والتقسيم إلى صفحات.

حدود المعدل

الطلبات محدودة المعدل لكل مفتاح. وتحمل كل استجابة الحصة المتبقية ونافذة إعادة التعيين، ليتمكن العميل من التراجع بسلاسة.

خطافات الويب

اشترك في أحداث التنفيذ لتصلك استدعاءات موقّعة مع إعادة محاولة تلقائية. وتحقّق من التوقيع قبل التعامل مع أي حمولة.

طلبك الأول

أنشئ مفتاحًا في مساحة عملك ضمن API Access، ثم اقرأ إحدى المجموعات. الاستجابات بصيغة JSON، ومحصورة بمساحة العمل المالكة للمفتاح.

قراءة المشاريع

curl https://matinsplatform.lovable.app/api/public/v1/projects \
  -H "Authorization: Bearer $MATIN_API_KEY" \
  -H "Accept: application/json"

الترشيح والتقسيم إلى صفحات

curl "https://matinsplatform.lovable.app/api/public/v1/projects?status=active&limit=50" \
  -H "Authorization: Bearer $MATIN_API_KEY"

ترويسات حدود المعدل في كل استجابة

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1756900000

ينطبق عزل المستأجرين على مستوى الصف على حركة الواجهة البرمجية تمامًا كما ينطبق داخل الواجهة — فلا يمكن لمفتاح أن يقرأ بيانات مساحة عمل أخرى مهما كانت المعرّفات في الطلب.

خطافات الويب

تُدفع أحداث التنفيذ إلى نقطة النهاية لديك مع توقيع HMAC. تحقّق من التوقيع قبل التعامل مع الحمولة، وأعد استجابة 2xx خلال عشر ثوانٍ وإلا أُعيدت المحاولة.

مثال على استدعاء راجع

POST /your-endpoint HTTP/1.1
X-Matin-Signature: sha256=<hex digest>
Content-Type: application/json

{
  "event": "project.status_changed",
  "occurred_at": "2026-08-24T09:14:22Z",
  "data": { "project_id": "prj_01J...", "from": "green", "to": "amber" }
}

هل تتكامل مع نظام بعينه؟

تخطيط موارد، Power BI، تبادل ثنائي الاتجاه مع Primavera — أخبرنا بالنظام ونخبرك بما تدعمه الواجهة البرمجية بالفعل.

اسألنا قدرات المنصة