الانتقال إلى المحتوى الرئيسي
POST
استيعاب إشارة المخاطر

الرؤوس

الاستجابة

string
معرف UUID لإشارة المخاطر التي تم إنشاؤها.
integer
درجة المخاطرة المستوعبة (0-100).
string
طابع زمني ISO 8601 للاستيعاب.

التفويضات

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

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

الجسم

application/json
signal_source
string
مطلوب
signal_type
string
مطلوب

تصنيف إشارة المخاطر

مثال:

"velocity_anomaly"

subject_id
string
مطلوب
subject_type
string
مطلوب
idempotency_key
string
ip_address
string
payload
any
risk_score
integer
user_agent
string

الاستجابة

تم استيعاب إشارة المخاطر

id
string<uuid>
tenant_id
string<uuid>
source
string

مصدر الإشارة (مثل device_fingerprint، ip_reputation، email_verification، document_analysis، behavioral)

مثال:

"device_fingerprint"

signal_type
string

تصنيف إشارة المخاطر

مثال:

"velocity_anomaly"

score
number<float>

درجة المخاطر بين 0 (لا يوجد خطر) و 1 (أعلى خطر)

النطاق المطلوب: 0 <= x <= 1
مثال:

0.85

details
object

بيانات وصفية عشوائية مرتبطة بالإشارة

مثال:
entity_type
enum<string>

نوع الكيان الذي تتعلق به هذه الإشارة

الخيارات المتاحة:
user,
device,
ip,
document,
session
مثال:

"user"

entity_id
string

معرف الكيان الذي يتم تقييمه

مثال:

"usr_8f14e45f"

created_at
string<date-time>