الانتقال إلى المحتوى الرئيسي
POST
curl
أنشئ حالة مرتبطة بموضوع واحد فقط. مرّر subject مباشرة، أو زوّد links ودع Didit يشتق الموضوع من مالك الكيان المرتبط الأول.
مرّر blueprint كلما توفر لديك. فهو يحدد أقسام صفحة الحالة التي تظهر، وهل يتطلب الحل ملاحظة، وإلى أين تُوجَّه الحالة عند التصعيد أو النقل.

ذات صلة

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

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

organization_id
string<uuid>
مطلوب

UUID الخاص بالمؤسسة.

application_id
string<uuid>
مطلوب

معرّف UUID للتطبيق.

الجسم

application/json
title
string
مطلوب
Maximum string length: 255
blueprint
string<uuid> | null

معرّف CaseBlueprint UUID. اتركه فارغاً لعدم استخدام أي مخطط.

priority
enum<string>
افتراضي:MEDIUM
الخيارات المتاحة:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null
tags
string[]
subject
object

مطلوب ما لم يتم توفير links؛ الموضوع الوحيد للحالة.

الجلسات/جلسات الشركات/المعاملات المطلوب إرفاقها عند الإنشاء، مثل [{"entity_type": "transaction", "entity_uuid": "..."}]. عند إغفال الموضوع (subject)، يُشتق الموضوع من مالك الرابط الأول.

assigned_to
string<uuid> | null

معرّف UUID للمستخدم للتعيين الفوري.

review_duplicates
boolean
افتراضي:false

إعادة التحقق من التحقيقات الحالية قبل إنشاء الحالة. عند تعيينه على true، يتطلب الخاضع للتحقق الذي لديه حالات سابقة قيمة غير فارغة لـ separate_incident_reason. تُفعّل لوحة التحكم هذه الحماية دائماً. يؤدي حذفه إلى الاحتفاظ بسلوك API الحالي.

separate_incident_reason
string
Maximum string length: 1000
source_context
object

الاستجابة

تم إنشاء الحالة.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
الخيارات المتاحة:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
الخيارات المتاحة:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
الخيارات المتاحة:
LOW,
MEDIUM,
HIGH
source
enum<string>
الخيارات المتاحة:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

المستخدم الوحيد أو الشركة الوحيدة التي ترتبط بها الحالة.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

فريق المراجعة المالك للحالة، أو null في حال عدم وجود فريق يملكها. يقوم التوجيه بتعيينه عندما تضع قاعدة توجيه الحالة لدى أحد فِرَقها. يمكنك تغييره أو مسحه باستخدام PATCH .../cases/{case_uuid}/ (team).

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

يُعيَّن فقط أثناء تجهيز قرار الموافقة الثنائية (4-eyes) على مخطط المدقق، في انتظار الموافقة أو رفض الموافقة.

checker
object | null

العضو المعيّن للموافقة على الحل المعلق أو رفضه. يتم تعيينه فقط أثناء انتظار حل بمبدأ الرقابة الرباعية لمُدقّق معيّن. ويكون Null عندما لا يكون هناك شيء معلق، وأثناء انتظار الحل المعلق في قائمة انتظار المُدقّق، وبمجرد الموافقة على الحل أو رفضه أو إعادته لمراجعة جديدة بسبب تغيّر الأدلة.

metadata
object
blueprint
object
notes
object[]

أحدث 50 ملاحظة.

events
object[]

أحدث 100 حدث.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
آخر تعديل في ٧ نوفمبر ٢٠٢٦