الانتقال إلى المحتوى الرئيسي
GET
التحقق من الإجماع
يعرض حالة الإجماع الحالية لطلب شاهد، بما في ذلك إحصاءات التصويت والتحديد النهائي. استخدم نقطة النهاية هذه للاستعلام عن اكتمال الإجماع أو لاسترداد النتيجة النهائية بعد أن يشهد الشهود. يتم حساب الإجماع تلقائيًا عندما يصل عدد الشهادات إلى عتبة required_witnesses. تحدد أغلبية بسيطة من أحكام confirm أو deny النتيجة. تُحتسب أصوات abstain ضمن النصاب القانوني ولكنها لا تؤثر على حساب الأغلبية.

المصادقة

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

الاستجابة

string
معرف طلب الشاهد.
string
ادعاء الحقيقة الذي كان يتم الشهادة عليه.
string
الحالة الحالية لطلب الشاهد. أحد الخيارات: - pending — لا يزال ينتظر الشهادات - confirmed — تم التوصل إلى توافق، وتم تأكيد المطالبة - denied — تم التوصل إلى توافق، تم رفض المطالبة - expired — انقضى TTL بدون الوصول إلى النصاب القانوني
integer
عدد الإثباتات المطلوبة للإجماع.
integer
عدد أحكام confirm المستلمة.
integer
عدد أحكام deny المستلمة.
integer
عدد أحكام abstain المستلمة.
boolean
ما إذا كان النصاب القانوني المطلوب قد اكتمل وتم اتخاذ قرار.
string
طابع زمني ISO 8601 عندما تم التوصل إلى توافق. null إذا كان لا يزال معلقًا أو انتهت صلاحيته دون توافق.
string
طابع زمني ISO 8601 لتاريخ انتهاء صلاحية طلب الشاهد (أو انتهى).

منطق الإجماع

التفويضات

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

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

معلمات المسار

witnessRequestID
string<uuid>
مطلوب

معرف مجموعة الشهود

الاستجابة

حالة الإجماع

reached
boolean
attestation_count
integer
required
integer
signatures
string[]