نظرة عامة على واجهة برمجة التطبيقات

لواجهة برمجة تطبيقات AppArch وجهان: مستوى التحكّم (المصادقة ومساحات العمل والباقات وتسجيل المشاريع) وواجهة برمجة تطبيقات التقارير (نقاط نهاية محمية برمز مميز تُرسِل إليها runners المحلّل نتائجها).

مصادقة الـ runner

تُقدّم الـ runners رمز bearer مميزًا خاصًا بالمشروع يُنشَأ عند تسجيل المشروع. ويقتصر نطاق الرمز المميز على مساحة عمل + مشروع + وحدة واحدة، ويمكن إبطاله من مدير بيانات الاعتماد.

POST /api/v1/reports
Authorization: Bearer apparch_proj_xxxxxxxx
Content-Type: application/json

الإصدارات

تخضع واجهة برمجة تطبيقات التقارير لإصدارات ضمن /api/v1/reports. ولأن الـ runners لا يمكن تحديثها فوريًا في بيئة العميل، تُبقى هذه الواجهة مستقرّة عبر الإصدارات؛ وتُثبَّت الـ runners على إصدار رئيسي محدّد.

معلومات النظام

يمكنك قراءة الإصدار ووضع النشر بشكل مجهول:

GET /api/v1/system/info
→ { "version": "...", "deploymentMode": "SaaS", "serverTimeUtc": "..." }