الانتقال إلى المحتوى الرئيسي
GET
curl
تعرض Business Console الأرقام نفسها فوق قائمة الأحداث. راجع إثراء IP في دليل استيعاب الأحداث لمعرفة السبب في أن القياسات عن بُعد منخفضة القيمة لا تحصل على الإثراء إلا عندما يكون حدث آخر قد حدّد العنوان مسبقاً، وإثراء IP للاطلاع على الحقول التي يحملها العنوان المُثرى.

التفويضات

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.

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

days
integer
افتراضي:30

طول الفترة بالأيام. القيمة الافتراضية هي 30؛ ويتم حصر القيم بين 1 و365، وفي حال إدخال قيمة ليست عدداً صحيحاً يتم الرجوع إلى 30 تلقائياً. تُعاد القيمة المطبقة كـ period_days.

النطاق المطلوب: 1 <= x <= 365

الاستجابة

العدادات والنسب للفترة.

events_ingested
integer
مطلوب

تم تخزين أحداث جديدة. لا يتم احتساب عمليات إعادة التشغيل المتوافقة مع idempotency.

events_rejected
integer
مطلوب

العناصر المرفوضة داخل طلبات الدفعات (مسارات الخادم والجهاز). لا يتم احتساب طلب الحدث الفردي المرفوض.

enrichment_lookups
integer
مطلوب

الأحداث التي تم حل عنوان IP العام الخاص بها، سواء من ذاكرة التخزين المؤقت أو حديثاً.

enrichment_cache_hits
integer
مطلوب

عمليات البحث التي تمت الإجابة عليها من التخزين المؤقت.

enrichment_provider_calls
integer
مطلوب

عمليات البحث التي تطلبت حلاً جديداً للعنوان.

enrichment_skipped_low_value
integer
مطلوب

أحداث القياس عن بُعد منخفضة القيمة التي لم يكن عنوانها معروفاً بالفعل. وهي لا تؤدي أبداً إلى عملية حلّ جديدة خاصة بها.

unique_ips_seen
integer
مطلوب

العناوين التي احتاجت إلى إعادة تحديدها.

period_days
integer
مطلوب

قيمة days المطبقة بعد التقييد.

cache_hit_rate
number | null
مطلوب

enrichment_cache_hits / enrichment_lookups، مقربة إلى 4 منازل عشرية. تكون Null عند عدم وجود عمليات بحث.

unique_ip_ratio
number | null
مطلوب

unique_ips_seen / events_ingested، مقربة إلى 4 أرقام عشرية. تكون Null عند عدم استيعاب أي أحداث.

provider_calls_per_1k_events
number | null
مطلوب

القرارات الجديدة لكل 1000 حدث تم استيعابه، مقربة إلى منزلتين عشريتين. تكون Null عند عدم استيعاب أي أحداث.

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