ابدأ الآن
التكامل / SDKs
التحقق من المستخدمين
التحقق من الشركات
مراقبة المعاملات
سجل التغييراتcurl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
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().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve("11111111-2222-3333-4444-555555555555")
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.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481000Z",
"received_at": "2026-10-17T09:15:02.903114Z",
"status": "IN_REVIEW",
"score": 40,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": "web-session-abc",
"device_fingerprint": "fp-a8c1",
"ip_address": "203.0.113.42",
"ip_country": "ES",
"amount": null,
"currency": null,
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": null,
"retention_class": "risk_relevant",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": true,
"payload": {
"method": "password"
},
"custom_values": {
"vip_tier": "gold",
"vpn_or_proxy_detected": true
},
"device_context": {
"fingerprint": "fp-a8c1",
"network_context": {
"ip_address": "203.0.113.42",
"ip_country": "Spain",
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false
}
},
"field_sources": {
"subject.vendor_data": "customer",
"event_category": "customer",
"action_type": "customer",
"occurred_at": "customer",
"received_at": "server",
"payload.method": "customer",
"session.session_id": "customer",
"session.sequence": "customer",
"device_context.fingerprint": "customer",
"device_context.network_context.ip_address": "customer",
"device_context.network_context.ip_country": "server",
"device_context.network_context.ip_country_code": "server",
"device_context.network_context.ip_city": "server",
"device_context.network_context.asn_number": "server",
"device_context.network_context.asn_organization": "server",
"device_context.network_context.is_vpn_or_tor": "server",
"device_context.network_context.is_data_center": "server"
},
"session_sequence": 142,
"table_id": null,
"hand_id": null,
"match_id": null,
"market_id": null,
"side": null,
"role": null,
"net_result_amount": null,
"payment_fingerprint": null,
"instrument_reference_hash": null,
"withdrawal_address_hash": null,
"dispute_id": null,
"chargeback_id": null,
"changed_field": null,
"identity_match_ref": null,
"schema_version": 1,
"expires_at": "2027-01-15T09:15:02.481000Z",
"rules_evaluated_count": 6,
"rule_runs": [
{
"rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"rule_title": "Login from VPN or Tor",
"library_key": null,
"matched": true,
"mode": "ACTIVE",
"is_async": false,
"severity": "MEDIUM",
"score_delta": 40,
"action_summary": "score +40; add_tag:VPN_LOGIN",
"matched_payload": [
{
"field": "event.ip.is_vpn_or_tor",
"operator": "eq",
"expected_value": true,
"current_value": true,
"matched": true,
"group_index": null,
"group_logic": "AND",
"field_source": "server"
}
],
"created_at": "2026-10-17T09:15:02.951207Z"
}
],
"ip_enrichment": {
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false,
"proxy_type": null,
"last_enriched_at": "2026-10-17T09:15:02.910442Z"
},
"subject_profile": null,
"tags": [
"VPN_LOGIN"
]
}الحصول على حدث المراقبة – واجهة API
استرجع من Didit حدثًا واحدًا للمراقبة مع الحمولة payload وسياق الجهاز وإثراء عنوان IP والإشارات المخزنة مؤقتًا والوسوم وأدلة القاعدة.
curl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
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().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve("11111111-2222-3333-4444-555555555555")
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.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481000Z",
"received_at": "2026-10-17T09:15:02.903114Z",
"status": "IN_REVIEW",
"score": 40,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": "web-session-abc",
"device_fingerprint": "fp-a8c1",
"ip_address": "203.0.113.42",
"ip_country": "ES",
"amount": null,
"currency": null,
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": null,
"retention_class": "risk_relevant",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": true,
"payload": {
"method": "password"
},
"custom_values": {
"vip_tier": "gold",
"vpn_or_proxy_detected": true
},
"device_context": {
"fingerprint": "fp-a8c1",
"network_context": {
"ip_address": "203.0.113.42",
"ip_country": "Spain",
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false
}
},
"field_sources": {
"subject.vendor_data": "customer",
"event_category": "customer",
"action_type": "customer",
"occurred_at": "customer",
"received_at": "server",
"payload.method": "customer",
"session.session_id": "customer",
"session.sequence": "customer",
"device_context.fingerprint": "customer",
"device_context.network_context.ip_address": "customer",
"device_context.network_context.ip_country": "server",
"device_context.network_context.ip_country_code": "server",
"device_context.network_context.ip_city": "server",
"device_context.network_context.asn_number": "server",
"device_context.network_context.asn_organization": "server",
"device_context.network_context.is_vpn_or_tor": "server",
"device_context.network_context.is_data_center": "server"
},
"session_sequence": 142,
"table_id": null,
"hand_id": null,
"match_id": null,
"market_id": null,
"side": null,
"role": null,
"net_result_amount": null,
"payment_fingerprint": null,
"instrument_reference_hash": null,
"withdrawal_address_hash": null,
"dispute_id": null,
"chargeback_id": null,
"changed_field": null,
"identity_match_ref": null,
"schema_version": 1,
"expires_at": "2027-01-15T09:15:02.481000Z",
"rules_evaluated_count": 6,
"rule_runs": [
{
"rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"rule_title": "Login from VPN or Tor",
"library_key": null,
"matched": true,
"mode": "ACTIVE",
"is_async": false,
"severity": "MEDIUM",
"score_delta": 40,
"action_summary": "score +40; add_tag:VPN_LOGIN",
"matched_payload": [
{
"field": "event.ip.is_vpn_or_tor",
"operator": "eq",
"expected_value": true,
"current_value": true,
"matched": true,
"group_index": null,
"group_logic": "AND",
"field_source": "server"
}
],
"created_at": "2026-10-17T09:15:02.951207Z"
}
],
"ip_enrichment": {
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false,
"proxy_type": null,
"last_enriched_at": "2026-10-17T09:15:02.910442Z"
},
"subject_profile": null,
"tags": [
"VPN_LOGIN"
]
}التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرّف Didit للحدث (event_uuid من استجابة الإنشاء أو الدُفعة أو القائمة أو المخطط الزمني)، وليس event_id الخاص بك.
الاستجابة
الحدث مع الأدلة الخاصة به.
حدث مراقبة واحد مع الغلاف الكامل الخاص به، وبيانات الإثراء وأدلة القواعد. يحتوي على كل حقول MonitoringEvent بالإضافة إلى الحقول أدناه.
معرّف Didit للحدث. استخدمه كـ {event_uuid} في استدعاءات الجلب والحذف.
المعرّف الخاص بك، وهو مفتاح الـ idempotency الذي أرسلته.
128فئة الحدث.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom ما حدث ضمن الفئة، كما أرسلته.
128وقت وقوع الحدث من جانبك.
وقت قبول Didit للحدث.
ACCEPTED: تم التخزين، ولم تُغير أي قاعدة مطابقة وضعه (وهي الاستجابة العادية لمعظم الأحداث، ودائماً ما تكون الاستجابة في تطبيق البيئة التجريبية، حيث لا يتم تشغيل أي قواعد). APPROVED: تطابقت قاعدة وبقيت الدرجة أقل من حد المراجعة الخاص بك. IN_REVIEW: رفعت قاعدةٌ الدرجةَ فوق حد المراجعة أو قامت بتعيين الحالة. DECLINED: رفضته قاعدةٌ أو تجاوزت الدرجةُ حد الرفض الخاص بك.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED درجة القاعدة المتراكمة. تبدأ من 0؛ وتغيرها إجراءات add_score للقاعدة (يُسمح بفروق سالبة).
subject.vendor_data للحدث: معرّفك الخاص بالمستخدم أو الشركة.
255individual أو company: نوع الكيان الذي يحدده subject_vendor_data.
"individual"
معرّف UUID للمستخدم (الفرد) أو الشركة التي انتهى إليها الحدث، أو null إذا لم يعد هذا السجل موجودًا.
الطرف الآخر في حدث P2P (تمت ترقيته من payload.counterparty_vendor_data).
255session.session_id المُرسل مع الحدث.
255device_context.fingerprint المُرسلة مع الحدث.
255عنوان IP للحدث. في مسار الخادم يكون هذا device_context.network_context.ip_address كما أرسلته؛ وفي مسار الجهاز يكون هو عنوان IP الخاص بالطلب.
64رمز الدولة لـ ip_address من إثراء عنوان IP، أو null إذا لم يتم إثراء العنوان (لأنه مفقود أو خاص، أو لأن بيانات القياس عن بُعد منخفضة القيمة ولم يكن العنوان معروفاً مسبقاً).
"ES"
المبلغ كسلسلة عشرية تتضمن 18 خانة عشرية، من transaction_context.amount أو payload.amount أو payload.stake_amount، بهذا الترتيب.
"250.000000000000000000"
العملة من transaction_context.currency أو payload.currency.
10تمت ترقيته من payload.game_id.
128تمت ترقيته من payload.round_id.
128تمت ترقيته من payload.bonus_id.
128تمت ترقيته من payload.affiliate_code.
128مرجع الدفع من transaction_context.payment_reference_id أو payload.payment_reference_id.
255فئة الاحتفاظ. أحداث الدفع والنزاعات هي monetary_or_compliance؛ وأحداث الأمان والمقامرة المسؤولة هي risk_relevant؛ وأحداث session.page_view وsession.sdk_heartbeat وsession.sdk_loaded وsession.device_seen وsession.bot_signal_observed وbonus.promotion_viewed وaffiliate.referral_clicked هي low_value؛ وكل ما عدا ذلك هو standard. تتم ترقية الحدث الذي تطابق مع قاعدة نشطة إلى risk_relevant (ولا يتم خفضه أبداً).
low_value, standard, risk_relevant, monetary_or_compliance عدد القواعد التي طابقت الحدث، بما في ذلك القواعد في وضع TEST (التي تسجل الأدلة ولكن لا تطبق أي إجراءات).
x >= 0تكون true طالما أن هناك قاعدة غير متزامنة (ربط بين الكيانات، أو تسلسل أطول من 24 ساعة) لا يزال يتعين تشغيلها لهذا الحدث. يتم حسمها في غضون دقائق ويتم تحديث status وscore وrules_matched_count في مكانها.
ما إذا كان بإمكان SDK تحت الضغط العكسي إسقاط أحداث من هذا النوع. تكون false لكل حدث من أحداث security وpayment وdispute وresponsible_gambling ولأحداث gameplay.bet_placed وgameplay.bet_settled وgameplay.p2p_settlement.
حقول الفئة التي أرسلتها في payload.
قيم custom_values المفردة التي أرسلتها. يضيف Didit القيمة vpn_or_proxy_detected: true أو is_data_center: true عندما يضع إثراء عنوان IP علامة تنبيه على العنوان ولم تقم بتعيين أيٍّ منهما.
سياق الجهاز كما تم تخزينه: device_context الخاص بك (بما في ذلك fingerprint وpersistent_device_id وbot_score عند إرسالها) مع إكمال network_context عبر إثراء عنوان IP (ip_country وip_country_code وip_city وasn_number وasn_organization وis_vpn_or_tor وis_data_center وproxy_type وconnection_type) للمفاتيح التي تركتها فارغة.
مسار الحقل الخاص بمصدره: customer (أرسله خادمك الخلفي)، أو sdk (أُرسل عبر مسار الجهاز)، أو server (مشتق بواسطة Didit، مثل received_at وحقول الشبكة المعززة). تحقق منه قبل اتخاذ إجراء بناءً على التطابق.
Show child attributes
Show child attributes
session.sequence المُرسل مع الحدث.
تمت ترقيته من payload.table_id.
128تمت ترقيته من payload.hand_id.
128تمت ترقيته من payload.match_id.
128تمت ترقيته من payload.market_id.
128تمت ترقيته من payload.side.
64تمت ترقيته من payload.role.
64تمت ترقيته من payload.net_result_amount، كسلسلة عشرية بـ 18 منزلة عشرية.
"-120.000000000000000000"
تمت ترقيته من payload.payment_fingerprint.
255تمت ترقيته من payload.instrument_reference_hash.
255تمت ترقيته من payload.withdrawal_address_hash (أو payload.destination_reference_hash).
255تمت ترقيته من payload.dispute_id.
255تمت ترقيته من payload.chargeback_id.
255تمت ترقيته من payload.changed_field (أحداث التغيير الأمني).
128تمت ترقيته من payload.identity_match_ref (تطابقات سجل المقامرة المسؤولة).
255إصدار مخطط غلاف الحدث. حالياً 1.
1
وقت انتهاء صلاحية الحدث بموجب فئة الاحتفاظ به وحذفه: occurred_at مضافاً إليه مدة الفئة (14 أو 30 أو 90 يوماً بشكل افتراضي، قابلة للتعديل لكل تطبيق). القيمة Null لأحداث monetary_or_compliance، والتي تتبع سياسة الاحتفاظ بالمعاملات.
عدد قواعد الأحداث التي تم تقييمها لهذا الحدث.
x >= 0كل قاعدة تطابقت مع الحدث، الأحدث أولاً.
Show child attributes
Show child attributes
إشارات مخاطر البريد الإلكتروني والهاتف المخزنة مؤقتاً للهدف، أو null في حال عدم وجود ملف تعريف للهدف.
Show child attributes
Show child attributes
أسماء الوسوم المرفقة بالحدث (إجراءات add_tags للقاعدة).