> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # عمليات التحقق اليوم حسب الساعة API > يعرض Didit عمليات التحقق من المستخدمين اليوم لكل ساعة محلية، مع نظيرتها في اليوم نفسه من الأسبوع الماضي، وعدد المقبولة وقيد المراجعة والمرفوضة. الحصول على عمليات التحقق اليوم حسب الساعة: أمر API نسخ الموجّه إلى الحافظة \

\`Read today's verifications of my Didit application hour by hour.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/analytics/today/

Authentication:
Use the x-api-key header with my Didit API key. Only a full-access key works: any scoped key gets 403 "This API key has no access to this endpoint.". application_id must be the application the key belongs to.

Goal:
\- Show today's verification volume by hour against the same weekday last week, and today's outcomes, in my own dashboard.

Query parameters:
\- tz - IANA time zone whose midnight starts today, for example Europe/Madrid. Omit it for UTC.

Behavior:
\- hours - 24 counts: today's user verification (KYC) sessions by the local hour they were created in. The hours still to come are 0.
\- previous_hours - the same 24 counts for previous_date, the same weekday one week before.
\- total - today's verifications so far. previous_total_so_far - the comparison day's up to the same local time, so (total - previous_total_so_far) / previous_total_so_far compares the same part of both days.
\- outcomes - of today's verifications, how many are approved, in review and declined now. The rest are not finished yet.
\- current_hour - the local hour it is now. A day on which the clocks change has 23 or 25 hours: the missing hour stays 0 and the repeated hour holds both.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/today/?tz=Europe%2FMadrid" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400 - {"tz": ["Unknown time zone: Europe/Atlantis."]} for a name the time zone database does not know.
\- 401 - the API key has expired.
\- 403 - missing or invalid key ({"detail": "Authentication credentials were not provided or are invalid."}), a key of another application ({"detail": "You do not have permission to perform this action."}), any scoped key, or a request from outside the key's IP list.
\- 429 - more than 600 GET requests per minute with this key.

Side effects: none. Not billed.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في تُعيد واجهة API من Didit الخاصة بعمليات التحقق اليوم حسب الساعة عدد عمليات التحقق من المستخدمين لكل ساعة من اليوم، ابتداءً من منتصف الليل في المنطقة الزمنية التي ترسلها، إلى جانب أعداد عمليات التحقق في الساعات نفسها من اليوم نفسه من الأسبوع الماضي. وهي البيانات التي تُعرض في بطاقة حجم العمليات في الصفحة الرئيسية لوحدة تحكم الأعمال.| الحقل | ما يحتويه | | - | - | | `hours` | عدد عمليات التحقق اليوم لكل ساعة محلية، ابتداءً من 00:00. الساعات التي لم تأتِ بعد تكون `0`. | | `previous_hours` | أعداد عمليات التحقق في الساعات نفسها في `previous_date`، أي يوم الأسبوع نفسه قبل أسبوع. | | `total`, `previous_total_so_far` | إجمالي اليوم حتى الآن، وإجمالي يوم المقارنة حتى الوقت المحلي نفسه. | | `outcomes` | من بين عمليات التحقق اليوم، عدد العمليات `approved` و`in_review` و`declined` في الوقت الحالي. |تُقرأ الأعداد مباشرةً من عمليات التحقق لديك، لذلك تُحتسب عملية التحقق التي أُنشئت قبل لحظات. للاطلاع على نطاق من التواريخ والأرقام الأخرى في لوحة التحكم، استخدم [الحصول على تحليلات التطبيق](https://docs.didit.me/ar/management-api/analytics/get.md).> [!NOTE] > > لا يمكن إلا لمفتاح API بصلاحيات كاملة استدعاء نقطة النهاية هذه. يتلقى مفتاح API بصلاحيات محدودة الخطأ `403` مهما كانت صلاحياته، والأمر نفسه ينطبق على مفتاح يتبع تطبيقاً آخر. راجع [مفاتيح API](https://docs.didit.me/ar/console/api-keys.md).## ذات صلة- [الحصول على تحليلات التطبيق](https://docs.didit.me/ar/management-api/analytics/get.md) - [لوحة تحكم التحليلات](https://docs.didit.me/ar/console/analytics.md) - [مفاتيح API والوصول المحدود](https://docs.didit.me/ar/console/api-keys.md) ## OpenAPI ````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/analytics/today/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/analytics/today/: get: tags: - Analytics summary: الحصول على عمليات التحقق اليوم حسب الساعة description: >- جلسات التحقق من المستخدمين (KYC) لليوم، بدءًا من منتصف الليل بالتوقيت المحلي في `tz`، محسوبة بحسب الساعة المحلية التي أُنشئت فيها، بجانب نفس الساعات من نفس اليوم من الأسبوع السابق، ومقسمة حسب النتيجة الحالية لكل منها: مقبولة، قيد المراجعة، أو مرفوضة. هذه هي بطاقة الحجم في الصفحة الرئيسية لـ Business Console. القيمة `total` تمثل إجمالي اليوم حتى الآن. بينما تحسب `previous_total_so_far` يوم المقارنة حتى نفس الوقت المحلي فقط، بحيث تقارن التغيرات بينهما نفس الجزء من كلا اليومين. وتكون الساعات المتبقية من اليوم `0`. واليوم الذي يتغير فيه التوقيت يحتوي على 23 أو 25 ساعة: الساعة المفقودة تبقى `0` والساعة المكررة تتضمن كلتيهما. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID الخاص بالمؤسسة. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- معرّف UUID للتطبيق. يجب أن يكون التطبيق الذي ينتمي إليه مفتاح API: أي مفتاح يُستخدم مع تطبيق آخر يتلقى الرمز `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- المنطقة الزمنية وفقاً لـ IANA التي يبدأ منتصف ليلها اليوم، على سبيل المثال `Europe/Madrid` أو `America/Mexico_City`. لا تُرسله لاستخدام UTC. responses: '200': description: >- عمليات التحقق لليوم حسب الساعة المحلية، وعمليات التحقق ليوم المقارنة، ونتائج اليوم. content: application/json: schema: $ref: '#/components/schemas/ApplicationAnalyticsToday' examples: Madrid, 14:00: value: time_zone: Europe/Madrid date: '2026-10-30' current_hour: 14 previous_date: '2026-10-23' hours: - 3 - 1 - 0 - 0 - 1 - 2 - 4 - 9 - 14 - 18 - 21 - 19 - 22 - 24 - 27 - 0 - 0 - 0 - 0 - 0 - 0 - 0 - 0 - 0 previous_hours: - 2 - 1 - 1 - 0 - 1 - 3 - 5 - 8 - 12 - 16 - 19 - 18 - 20 - 22 - 24 - 26 - 23 - 19 - 15 - 12 - 9 - 7 - 5 - 3 total: 165 previous_total_so_far: 151 outcomes: approved: 139 in_review: 6 declined: 18 '400': description: >- منطقة زمنية غير معروفة. يكون نص الاستجابة مفهرساً بالمعامل، مع قائمة من الرسائل. content: application/json: schema: type: object additionalProperties: type: array items: type: string examples: Unknown time zone: value: tz: - 'Unknown time zone: Europe/Atlantis.' '401': description: >- انتهت صلاحية مفتاح API. المفتاح الذي تم إنشاؤه مع تاريخ انتهاء هو فقط الذي يمكن أن تنتهي صلاحيته؛ بعد هذا التاريخ، تجيب جميع الطلبات باستخدامه بـ `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- الطلب غير مسموح به. اقرأ `detail`: مفتاح API مفقود أو غير صالح (لا يُرجع `401` مطلقاً)، أو مفتاح لتطبيق آخر، أو أي مفتاح ذو نطاق محدد، أو طلب من خارج قائمة العناوين الخاصة بالمفتاح. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: >- Authentication credentials were not provided or are invalid. Another application: value: detail: You do not have permission to perform this action. Scoped key: value: detail: This API key has no access to this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '429': description: >- أكثر من 600 طلب GET في الدقيقة باستخدام مفتاح API هذا. انتظر لعدد الثواني المحدد في `Retry-After`، ثم أعد المحاولة. content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: عدد الثواني حتى إعادة تعيين النافذة الحالية البالغة دقيقة واحدة. schema: type: integer example: 23 X-RateLimit-Limit: description: الطلبات المسموح بها في الدقيقة ضمن هذه الميزانية. schema: type: integer X-RateLimit-Remaining: description: الطلبات المتبقية في النافذة الحالية. schema: type: integer X-RateLimit-Reset: description: توقيت Unix عند إعادة تعيين النافذة. schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/today/?tz=Europe%2FMadrid' \ -H 'x-api-key: YOUR_API_KEY' components: schemas: ApplicationAnalyticsToday: type: object description: >- عمليات التحقق لليوم حسب الساعة المحلية مقارنة بنفس اليوم من الأسبوع الماضي. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: المنطقة الزمنية لـ IANA التي يقع فيها اليوم وساعاته. example: Europe/Madrid date: type: string format: date description: اليوم في تلك المنطقة الزمنية. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: الساعة المحلية الآن. example: 14 previous_date: type: string format: date description: 'يوم المقارنة: نفس اليوم من الأسبوع قبل أسبوع واحد.' example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- عمليات التحقق التي تم إنشاؤها اليوم، لكل ساعة محلية بدءاً من 00:00. الساعات القادمة تكون قيمتها 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- عمليات التحقق التي تم إنشاؤها في يوم المقارنة، لكل ساعة محلية بدءاً من 00:00. total: type: integer minimum: 0 description: عمليات التحقق التي تم إنشاؤها اليوم حتى الآن. example: 165 previous_total_so_far: type: integer minimum: 0 description: عمليات التحقق التي تم إنشاؤها في يوم المقارنة حتى نفس الوقت المحلي. example: 151 outcomes: type: object description: >- من بين عمليات التحقق اليوم، كم عدد العمليات المقبولة، والتي تنتظر المراجعة، والمرفوضة حالياً. الباقي لم يكتمل بعد. required: - approved - in_review - declined properties: approved: type: integer minimum: 0 in_review: type: integer minimum: 0 declined: type: integer minimum: 0 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.