الانتقال إلى المحتوى الرئيسي
POST
curl
أنشئ مخططًا. يخضع content_config للتحقق الصارم، فلا يُقبل إلا الأقسام الستة المعروفة ومفاتيحها الموثقة. لذلك يؤدي الخطأ المطبعي إلى إرجاع خطأ 400 بدلاً من تجاهله بصمت.

ذات صلة

التفويضات

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
name
string
مطلوب

بحد أقصى 24 حرفاً، على سبيل المثال "تحقيق AML".

Maximum string length: 24
assignee_pool
string<uuid>[]
مطلوب

قائمة بمعرّفات UUID للمستخدمين. يتم رفض المصفوفات الفارغة بالرسالة "Pick at least one assignee".

Minimum array length: 1
description
string | null
assignment_method
enum<string>
افتراضي:MANUAL
الخيارات المتاحة:
MANUAL,
AUTOMATIC
max_active_cases
integer | null

حد الوضع التلقائي: "أقل من N من الحالات المسندة لهذا المخطط".

النطاق المطلوب: x >= 1
escalation_enabled
boolean
افتراضي:false
escalation_blueprint
string<uuid> | null

معرّف UUID للمخطط المستهدف. لا يُفرض ذلك عند الحفظ، ولكن إجراء التصعيد سيفشل بالرمز 400 حتى يتم تعيين كل من escalation_enabled وescalation_blueprint.

transfer_enabled
boolean
افتراضي:false
four_eyes_checker_blueprint
string<uuid> | null

يؤدي ضبط هذا الخيار إلى تمكين مراجعة بأربعة أعين: تُوضَع القرارات الخاصة بهذا المخطط في قائمة انتظار مخطط المدقِّق.

require_resolution_note
boolean
افتراضي:false
content_config
object

الأقسام الستة القابلة للتبديل التي تحدد علامات التبويب والحقول التي تظهر في صفحة الحالة. يتم رفض الأقسام أو المفاتيح غير المعروفة.

is_active
boolean
افتراضي:true
default_deadline_hours
integer | null

الموعد النهائي الافتراضي للحالات المفتوحة حديثاً. المواعيد النهائية للحالات الحالية تظل دون تغيير.

النطاق المطلوب: 1 <= x <= 8760
publish
boolean
افتراضي:true
write-only

عَيِّن القيمة إلى false لحفظ مسودة لم تُنشر من قبل. يظل السجل غير نشط في الإصدار 0 حتى يتم نشر المسودة صراحةً. يؤدي إغفال هذا الحقل إلى الحفاظ على الإنشاء الفوري لعمليات التكامل الحالية.

الاستجابة

تم إنشاء المخطط الأولي (Blueprint).

uuid
string<uuid>
name
string
Maximum string length: 24
description
string | null
assignment_method
enum<string>
الخيارات المتاحة:
MANUAL,
AUTOMATIC
assignee_pool
string<uuid>[]
max_active_cases
integer | null
escalation_enabled
boolean
transfer_enabled
boolean
require_resolution_note
boolean
is_active
boolean
preset_key
string | null
created_at
string<date-time>
escalation_blueprint
string<uuid> | null
escalation_blueprint_name
string | null
four_eyes_checker_blueprint
string<uuid> | null
four_eyes_checker_blueprint_name
string | null
content_config
object

الأقسام الستة القابلة للتبديل التي تحدد علامات التبويب والحقول التي تظهر في صفحة الحالة. يتم رفض الأقسام أو المفاتيح غير المعروفة.

creation_sources
object[]

الموصلات التي توجّه حالياً حالات جديدة إلى هذا المخطط.

receives_escalation_from
object[]

المخططات الأخرى التي يشير هدف التصعيد الخاص بها إلى هذا المخطط.

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
النطاق المطلوب: 1 <= x <= 8760
آخر تعديل في ٧ نوفمبر ٢٠٢٦