نظرة عامةEnglish
عقد التكامل

API موحدة تحت /api و/api/v1

البشر يستخدمون جلسة الحساب وعضوية المشروع. التكاملات فقط تستخدم Bearer service keys محدودة الصلاحية. الواجهة الإصدارية تعيد كتابة الطلب إلى نفس المنطق.

01

الهوية والصلاحيات

جلسة الحساب تحدد الشخص، وعضوية المشروع تحدد صلاحياته؛ مفاتيح الخدمة للبرامج فقط.

  • الإنسان: session cookie مشفر + projectId مختار وموثق
  • التكامل: Authorization: Bearer SERVICE_KEY
  • owner/editor/reviewer/viewer — أدوار أعضاء مسمّين
  • srs:edit — مفتاح خدمة محدود لمحرر موثوق
  • widget:write — إرسال البلاغ والدليل فقط
  • agent:execute — أوامر الاختبار وتأجير الاعتماد وتسجيل النتائج
  • read:demo — يعمل فقط عند تفعيل الديمو صراحة
02

مشروع وSRS

مصادر المشروع والإصدارات والتخصيص.

  • GET/POST /api/account-projects
  • GET/PATCH /api/projects
  • GET /api/srs-graph و/api/srs-source-audit
  • GET /api/srs-story/:id و/api/srs-workflow/:id
  • POST/PATCH /api/story-edits
  • GET/POST /api/project-traceability و/api/validation-transfer
03

الجودة والتنفيذ

تخطيط الاختبار وحالته ونتيجته.

  • GET/POST/PATCH /api/test-commands
  • GET/POST /api/test-runs
  • GET/POST /api/run-state
  • POST /api/agent/plan و/api/agent/suite
  • GET/POST /api/project-scenarios
  • GET /api/route-catalog و/api/route-candidates
04

البلاغات والأدلة والتشغيل

البلاغ والصورة المنشأة يظلان داخل نطاق المشروع.

  • GET/POST /api/issues وPATCH /api/issues/:id
  • POST /api/issues/:id/attachments
  • GET/POST /api/ai-images للصور الخاصة بالمشروع
  • GET /api/files/:key برابط موقع ومؤقت
  • GET/POST/PATCH /api/system-logs
  • GET /api/health وGET /api/ready
  • GET /api/project-handoff لوصف التسليم