الانتقال إلى المحتوى الرئيسي
POST
إنشاء فحص امتثال
ينفذ تقييم امتثال آلي لكيان معين (وكيل، نموذج، مجموعة بيانات، أو سير عمل) مقابل لائحة مدعومة. يتحقق الفحص من تكوين الكيان، وأنماط الوصول، ومعالجة البيانات، ومسار التدقيق مقابل متطلبات اللائحة وينتج تحديد امتثال مع نتائج مفصلة. فحوصات الامتثال متطابقة لنفس زوج الكيان-التنظيم ضمن نافذة 24 ساعة. تعيد المكالمات المتكررة ضمن تلك النافذة النتيجة المخزنة مؤقتًا.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

string
معرف فريد لسجل فحص الامتثال. التنسيق: maip-cc:ULID.
string
نوع الكيان الذي تم تقييمه.
string
معرف الكيان الذي تم تقييمه.
string
اللائحة التي تم تقييمها.
string
نطاق التقييم. full إذا لم يتم تحديد نطاق.
string
تحديد الامتثال. أحد الخيارات التالية: - compliant — الكيان يفي بجميع المتطلبات المقدرة - non_compliant — الكيان يفشل في واحد أو أكثر من المتطلبات الحرجة المتطلبات - partial — الكيان يلبي بعض المتطلبات وليس كلها
object[]
قائمة مفصلة بالنتائج الفردية من التقييم.
string
إيصال MAIP الذي تم سكه لفحص الامتثال هذا، مما يوفر إيصالًا غير قابل للتغيير سجل التدقيق.
string
طابع زمني ISO 8601 لتاريخ إجراء التقييم.

اللوائح المدعومة

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

الجسم

application/json
auditor_id
string
مطلوب
entity_id
string
مطلوب
regulation
string
مطلوب
requirement_id
string
مطلوب
result
string
مطلوب
check_type
string
entity_type
string
evidence_hash
string | null
metadata
any
notes
string
ttl_days
integer

الاستجابة

تم إنشاء فحص الامتثال

check_id
string<uuid>
agent_id
string<uuid>
framework
enum<string>
الخيارات المتاحة:
soc2,
iso27001,
hipaa,
gdpr
scope
object
status
enum<string>
الخيارات المتاحة:
pending,
passed,
failed,
partial
findings
object[]
created_at
string<date-time>