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

المصادقة

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

الاستجابة

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

دورة حياة الشاهد

التفويضات

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

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

الجسم

application/json
claim_type
string
مطلوب
requester_agent_id
string
مطلوب
claim_payload
any
required_witnesses
integer
threshold
integer
ttl_minutes
integer

الاستجابة

تم إنشاء مجموعة شهود

witness_id
string<uuid>
name
string
required_attestations
integer
agent_ids
string<uuid>[]
status
enum<string>
الخيارات المتاحة:
pending,
active,
completed
created_at
string<date-time>