الانتقال إلى المحتوى الرئيسي
GET
curl
تُعيد واجهة API من Didit الخاصة بعمليات التحقق اليوم حسب الساعة عدد عمليات التحقق من المستخدمين لكل ساعة من اليوم، ابتداءً من منتصف الليل في المنطقة الزمنية التي ترسلها، إلى جانب أعداد عمليات التحقق في الساعات نفسها من اليوم نفسه من الأسبوع الماضي. وهي البيانات التي تُعرض في بطاقة حجم العمليات في الصفحة الرئيسية لوحدة تحكم الأعمال. تُقرأ الأعداد مباشرةً من عمليات التحقق لديك، لذلك تُحتسب عملية التحقق التي أُنشئت قبل لحظات. للاطلاع على نطاق من التواريخ والأرقام الأخرى في لوحة التحكم، استخدم الحصول على تحليلات التطبيق.
لا يمكن إلا لمفتاح API بصلاحيات كاملة استدعاء نقطة النهاية هذه. يتلقى مفتاح API بصلاحيات محدودة الخطأ 403 مهما كانت صلاحياته، والأمر نفسه ينطبق على مفتاح يتبع تطبيقاً آخر. راجع مفاتيح API.

ذات صلة

التفويضات

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 للتطبيق. يجب أن يكون التطبيق الذي ينتمي إليه مفتاح API: أي مفتاح يُستخدم مع تطبيق آخر يتلقى الرمز 403.

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

tz
string
افتراضي:UTC

المنطقة الزمنية وفقاً لـ IANA التي يبدأ منتصف ليلها اليوم، على سبيل المثال Europe/Madrid أو America/Mexico_City. لا تُرسله لاستخدام UTC.

مثال:

"Europe/Madrid"

الاستجابة

عمليات التحقق لليوم حسب الساعة المحلية، وعمليات التحقق ليوم المقارنة، ونتائج اليوم.

عمليات التحقق لليوم حسب الساعة المحلية مقارنة بنفس اليوم من الأسبوع الماضي.

time_zone
string
مطلوب

المنطقة الزمنية لـ IANA التي يقع فيها اليوم وساعاته.

مثال:

"Europe/Madrid"

date
string<date>
مطلوب

اليوم في تلك المنطقة الزمنية.

مثال:

"2026-10-30"

current_hour
integer
مطلوب

الساعة المحلية الآن.

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

14

previous_date
string<date>
مطلوب

يوم المقارنة: نفس اليوم من الأسبوع قبل أسبوع واحد.

مثال:

"2026-10-23"

hours
integer[]
مطلوب

عمليات التحقق التي تم إنشاؤها اليوم، لكل ساعة محلية بدءاً من 00:00. الساعات القادمة تكون قيمتها 0.

Required array length: 24 elements
النطاق المطلوب: x >= 0
previous_hours
integer[]
مطلوب

عمليات التحقق التي تم إنشاؤها في يوم المقارنة، لكل ساعة محلية بدءاً من 00:00.

Required array length: 24 elements
النطاق المطلوب: x >= 0
total
integer
مطلوب

عمليات التحقق التي تم إنشاؤها اليوم حتى الآن.

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

165

previous_total_so_far
integer
مطلوب

عمليات التحقق التي تم إنشاؤها في يوم المقارنة حتى نفس الوقت المحلي.

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

151

outcomes
object
مطلوب

من بين عمليات التحقق اليوم، كم عدد العمليات المقبولة، والتي تنتظر المراجعة، والمرفوضة حالياً. الباقي لم يكتمل بعد.

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