curl -X GET 'https://verification.didit.me/v3/events/enrichment-metrics/?days=30' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve_enrichment_metrics()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieveEnrichmentMetrics();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.RetrieveEnrichmentMetrics(ctx, didit.MonitoringEventsRetrieveEnrichmentMetricsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.monitoringEvents().retrieveEnrichmentMetrics();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieveEnrichmentMetrics();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve_enrichment_metrics
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.MonitoringEvents.RetrieveEnrichmentMetricsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"events_ingested": 128450,
"events_rejected": 214,
"enrichment_lookups": 41230,
"enrichment_cache_hits": 40118,
"enrichment_provider_calls": 1112,
"enrichment_skipped_low_value": 74320,
"unique_ips_seen": 1112,
"period_days": 30,
"cache_hit_rate": 0.973,
"unique_ip_ratio": 0.0087,
"provider_calls_per_1k_events": 8.66
}مقاييس إثراء الأحداث عبر واجهة برمجة التطبيقات
يعرض Didit عدادات استيعاب الأحداث وإثراء IP لفترة محددة: معدل إصابة الذاكرة المؤقتة، ونسبة IP الفريدة، وعمليات البحث الجديدة لكل ألف حدث.
curl -X GET 'https://verification.didit.me/v3/events/enrichment-metrics/?days=30' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve_enrichment_metrics()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieveEnrichmentMetrics();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.RetrieveEnrichmentMetrics(ctx, didit.MonitoringEventsRetrieveEnrichmentMetricsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.monitoringEvents().retrieveEnrichmentMetrics();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieveEnrichmentMetrics();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve_enrichment_metrics
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.MonitoringEvents.RetrieveEnrichmentMetricsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"events_ingested": 128450,
"events_rejected": 214,
"enrichment_lookups": 41230,
"enrichment_cache_hits": 40118,
"enrichment_provider_calls": 1112,
"enrichment_skipped_low_value": 74320,
"unique_ips_seen": 1112,
"period_days": 30,
"cache_hit_rate": 0.973,
"unique_ip_ratio": 0.0087,
"provider_calls_per_1k_events": 8.66
}التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات الاستعلام
طول الفترة بالأيام. القيمة الافتراضية هي 30؛ ويتم حصر القيم بين 1 و365، وفي حال إدخال قيمة ليست عدداً صحيحاً يتم الرجوع إلى 30 تلقائياً. تُعاد القيمة المطبقة كـ period_days.
1 <= x <= 365الاستجابة
العدادات والنسب للفترة.
تم تخزين أحداث جديدة. لا يتم احتساب عمليات إعادة التشغيل المتوافقة مع idempotency.
العناصر المرفوضة داخل طلبات الدفعات (مسارات الخادم والجهاز). لا يتم احتساب طلب الحدث الفردي المرفوض.
الأحداث التي تم حل عنوان IP العام الخاص بها، سواء من ذاكرة التخزين المؤقت أو حديثاً.
عمليات البحث التي تمت الإجابة عليها من التخزين المؤقت.
عمليات البحث التي تطلبت حلاً جديداً للعنوان.
أحداث القياس عن بُعد منخفضة القيمة التي لم يكن عنوانها معروفاً بالفعل. وهي لا تؤدي أبداً إلى عملية حلّ جديدة خاصة بها.
العناوين التي احتاجت إلى إعادة تحديدها.
قيمة days المطبقة بعد التقييد.
enrichment_cache_hits / enrichment_lookups، مقربة إلى 4 منازل عشرية. تكون Null عند عدم وجود عمليات بحث.
unique_ips_seen / events_ingested، مقربة إلى 4 أرقام عشرية. تكون Null عند عدم استيعاب أي أحداث.
القرارات الجديدة لكل 1000 حدث تم استيعابه، مقربة إلى منزلتين عشريتين. تكون Null عند عدم استيعاب أي أحداث.