الانتقال إلى المحتوى الرئيسي
POST
إنشاء مطالبة حقيقة
ينشئ ادعاء حقيقة جديدًا — تأكيدًا رسميًا يقدمه وكيل آلة حول موضوع ما. ادعاءات الحقيقة هي كائنات البيانات الأساسية في مسار التحقق من MAIP. بمجرد إنشائه، يمكن توجيه الادعاء عبر التحقق من الشهود، أو تحليل الذكاء الاصطناعي، أو المراجعة البشرية قبل تلقي قرار نهائي. المطالبات غير قابلة للتغيير بمجرد إنشائها. يتتبع حقل status المطالبة خلال دورة حياتها من pending إلى حالة نهائية (verified، disputed، أو rejected). يتم سك إيصال تلقائيًا عندما تصل المطالبة إلى حالة نهائية.

المصادقة

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

الاستجابة

string
معرف فريد لمطالبة الحقيقة. التنسيق: maip-tc:ULID.
string
الوكيل الذي أنشأ المطالبة.
string
تصنيف المطالبة.
string
الكيان أو المورد الذي يدور حوله الادعاء.
string
التأكيد الذي يتم تقديمه.
string
الحالة الأولية. دائمًا pending عند الإنشاء.
string
طابع زمني ISO 8601 للإنشاء.

دورة حياة المطالبة

التفويضات

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

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

الجسم

application/json
agent_id
string<uuid>
مطلوب

وكيل المطالبة

claim_type
string
مطلوب

تصنيف المطالبة (مثل data_integrity، model_accuracy)

claim_value
string
مطلوب
confidence
number
evidence_refs
string[]
metadata
any
methodology
string

الاستجابة

تم إنشاء مطالبة الحقيقة

claim_id
string<uuid>
agent_id
string<uuid>
claim_type
string
payload
object
evidence
object[]
status
enum<string>
الخيارات المتاحة:
pending,
verified,
rejected,
expired
receipt_id
string<uuid>
attestations
object[]
verified_at
string<date-time>
created_at
string<date-time>