الانتقال إلى المحتوى الرئيسي
GET
curl
اعرض الحالات الخاصة بالتطبيق، وترتيبها افتراضياً من الأحدث إلى الأقدم. كل خيار تصفية وترتيب متاح في قائمة الحالات في وحدة التحكم معروض كمعامل استعلام، بما في ذلك البحث النصي الكامل عبر search في الموضوع والوسوم ورقم الحالة ومعرّفات الجلسات أو المعاملات المرتبطة. ترتبط بكل حالة أيضاً team التابع لها، والـchecker المسمّى لقرار المراجعة المزدوجة (four-eyes) المعلّق، وcountry الخاصة بصاحب الحالة وportrait الخاص به.

الوصول

تحتاج نقاط نهاية الحالات إلى مفتاح API بصلاحية وصول كاملة. يتلقى المفتاح ذو الصلاحية المقيدة الاستجابة 403.

ذات صلة

التفويضات

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 للتطبيق.

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

limit
integer
افتراضي:50

حجم الصفحة. القيمة الافتراضية 50.

النطاق المطلوب: x >= 1
offset
integer
افتراضي:0

إزاحة تستند إلى الصفر للسجل الأول.

النطاق المطلوب: x >= 0
status__in
string

الحالات المفصولة بفواصل لتضمينها، مثل OPEN,AWAITING_USER.

priority
string

الأولويات المفصولة بفواصل لتضمينها.

source__in
string

المصادر المفصولة بفواصل لتضمينها.

blueprint
string<uuid>

التصفية للحالات ضمن هذا المخطط.

assigned_to
string<uuid>

التصفية للحالات المعيّنة لهذا المستخدم.

unassigned
boolean

true للحالات غير المعينة، وfalse للحالات المعينة.

tag
string

التصفية للحالات التي تحمل هذا الوسم تحديداً.

يطابق title، أو case_number، أو tag، أو اسم الموضوع/UUID/المعرّف الخارجي، أو UUID للجلسة المرتبطة، أو UUID للمعاملة المرتبطة.

date_from
string<date>

الحد الأدنى لتاريخ الإنشاء (شامل).

date_to
string<date>

الحد الأقصى لتاريخ الإنشاء (شامل).

due_before
string<date-time>

الحد الأقصى لـ due_at.

overdue
boolean

true لإرجاع الحالات المفتوحة/في انتظار المستخدم والمتأخرة فقط.

ordering
enum<string>
افتراضي:-created_at

ترتيب الفرز. يفرز due_at القيم الفارغة في النهاية.

الخيارات المتاحة:
created_at,
-created_at,
due_at,
-due_at

الاستجابة

200 - application/json

قائمة الحالات مقسمة إلى صفحات.

count
integer

عدد الصفوف المطابقة. دقيق حتى 100، ويقتصر على 100 كحد أقصى بعد ذلك لأسباب تتعلق بالأداء. اعتمد على كون next بقيمة null لتحديد الصفحة الأخيرة.

next
string | null

رابط URL مطلق للصفحة التالية، أو null.

previous
string | null

رابط URL مطلق للصفحة السابقة، أو null.

results
object[]
آخر تعديل في ٧ نوفمبر ٢٠٢٦