ابدأ الآن
التكامل / SDKs
التحقق من المستخدمين
التحقق من الشركات
مراقبة المعاملات
سجل التغييراتcurl -X GET 'https://verification.didit.me/v3/events/subjects/user-42/?entity_type=individual&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.monitoring_events.retrieve_subject_timeline(
"user-42",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.monitoringEvents.retrieveSubjectTimeline("user-42")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.MonitoringEvents.RetrieveSubjectTimelineAutoPaging(ctx, "user-42", didit.MonitoringEventsRetrieveSubjectTimelineParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.monitoringEvents().retrieveSubjectTimeline("user-42")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->monitoringEvents->retrieveSubjectTimeline('user-42') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.monitoring_events.retrieve_subject_timeline("user-42").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.MonitoringEvents.RetrieveSubjectTimelineAsync("user-42"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "chargeback-2026-10-16-000318",
"event_category": "dispute",
"action_type": "chargeback_opened",
"occurred_at": "2026-10-16T14:02:11Z",
"received_at": "2026-10-16T14:02:12.418230Z",
"status": "IN_REVIEW",
"score": 60,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": null,
"device_fingerprint": null,
"ip_address": null,
"ip_country": null,
"amount": "250.000000000000000000",
"currency": "EUR",
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": "dep_735",
"retention_class": "monetary_or_compliance",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": false
},
{
"event_uuid": "22222222-3333-4444-5555-666666666666",
"event_id": "login-2026-10-15-000912",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-15T08:30:00.120000Z",
"received_at": "2026-10-15T08:30:00.734512Z",
"status": "ACCEPTED",
"score": 0,
"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": "standard",
"rules_matched_count": 0,
"correlation_pending": false,
"is_droppable": true
}
]
}الجدول الزمني لأحداث المراقبة عبر API
يسرد Didit كل أحداث المراقبة لمستخدم واحد أو شركة واحدة، من الأحدث إلى الأقدم، مع الفصل بين الأفراد والشركات التي تشترك في vendor_data.
curl -X GET 'https://verification.didit.me/v3/events/subjects/user-42/?entity_type=individual&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.monitoring_events.retrieve_subject_timeline(
"user-42",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.monitoringEvents.retrieveSubjectTimeline("user-42")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.MonitoringEvents.RetrieveSubjectTimelineAutoPaging(ctx, "user-42", didit.MonitoringEventsRetrieveSubjectTimelineParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.monitoringEvents().retrieveSubjectTimeline("user-42")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->monitoringEvents->retrieveSubjectTimeline('user-42') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.monitoring_events.retrieve_subject_timeline("user-42").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.MonitoringEvents.RetrieveSubjectTimelineAsync("user-42"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "chargeback-2026-10-16-000318",
"event_category": "dispute",
"action_type": "chargeback_opened",
"occurred_at": "2026-10-16T14:02:11Z",
"received_at": "2026-10-16T14:02:12.418230Z",
"status": "IN_REVIEW",
"score": 60,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": null,
"device_fingerprint": null,
"ip_address": null,
"ip_country": null,
"amount": "250.000000000000000000",
"currency": "EUR",
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": "dep_735",
"retention_class": "monetary_or_compliance",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": false
},
{
"event_uuid": "22222222-3333-4444-5555-666666666666",
"event_id": "login-2026-10-15-000912",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-15T08:30:00.120000Z",
"received_at": "2026-10-15T08:30:00.734512Z",
"status": "ACCEPTED",
"score": 0,
"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": "standard",
"rules_matched_count": 0,
"correlation_pending": false,
"is_droppable": true
}
]
}التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
المعرّف الخاص بك للكيان (subject.vendor_data لأحداثه). شفّره بترميز URL؛ لا يمكن لـ endpoint هذا معالجة قيمة تحتوي على /.
1 - 255معلمات الاستعلام
تُرجع القيمة company الشركة المرتبطة بقيمة vendor_data هذه؛ بينما يُرجع أي قيمة أخرى، أو عدم تقديم قيمة، الفرد. تُقبل subject_entity_type كاسم بديل عند غياب entity_type.
individual, company الحد الأقصى لعدد الأحداث لكل صفحة. القيمة الافتراضية هي 50. تُرْجِع القيم التي تزيد عن 1000000 الرمز 400؛ وأي قيمة غير عددية أو صفرية أو سالبة تعود تلقائياً إلى 50.
1 <= x <= 1000000عدد الأحداث المراد تخطيها. القيمة الافتراضية هي 0. يُفضّل تتبّع رابط next من الاستجابة.
0 <= x <= 1000000الأحداث في هذه الفئات فقط. كرر المعامل لعدة قيم (?event_category=payment&event_category=dispute)؛ ويتم إرجاع أي حدث يطابق أيًا منها.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom فقط الأحداث التي تتضمن أنواع الإجراءات هذه (مطابقة تامة، حساسة لحالة الأحرف). كرر لعدة قيم.
فقط الأحداث التي لها هذه الحالات. كرر لعدة قيم.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED الأحداث في فئات الاحتفاظ هذه فقط. كرر لعدة قيم.
low_value, standard, risk_relevant, monetary_or_compliance تطابق تام في business.vendor_data المرسل مع الحدث.
تطابق تام في session.session_id.
تطابق تام في device_context.fingerprint.
تطابق تام في عنوان IP الخاص بالحدث.
تطابق تام في game_id المُروَّج إلى المستوى الأعلى.
تطابق تام مع round_id المُروَّج إلى المستوى الأعلى.
تطابق تام مع affiliate_code المُروَّج إلى المستوى الأعلى.
تطابق تام في مرجع الدفع (من transaction_context.payment_reference_id أو payload.payment_reference_id).
تطابق تام في counterparty_vendor_data المُروَّج إلى المستوى الأعلى.
تُرجع القيمة true (وكذلك 1 أو yes، بدون تحسس لحالة الأحرف) الأحداث التي طابقت قاعدة واحدة على الأقل فقط (rules_matched_count أكبر من 0). وتُتجاهل أي قيمة أخرى.
فقط الأحداث التي يكون فيها occurred_at في هذه اللحظة أو بعدها (شاملًا). أرسل قيمة بتنسيق ISO 8601: مثل 2026-10-01T00:00:00Z، أو إزاحة صريحة مع ترميز + بنسبة مئوية (2026-10-01T02:00:00%2B02:00؛ حيث يتم فك ترميز + غير المرمز كمسافة وتتعذر قراءة القيمة)، أو تاريخ بمفرده (2026-10-01)، وهو ما يعني 00:00:00 UTC من ذلك اليوم. تُقرأ القيمة بدون إزاحة على أنها بتوقيت UTC. لا تُقبل القيم بأي تنسيق آخر.
فقط الأحداث التي يكون فيها occurred_at في هذه اللحظة أو قبلها (شاملًا). التاريخ بمفرده يعني بداية ذلك اليوم، لذا فإن occurred_to=2026-10-15 يستبعد بقية يوم 15 أكتوبر؛ أرسل 2026-10-15T23:59:59Z لتضمينه. أرسل قيمة بتنسيق ISO 8601: مثل 2026-10-01T00:00:00Z، أو إزاحة صريحة مع ترميز + بنسبة مئوية (2026-10-01T02:00:00%2B02:00؛ حيث يتم فك ترميز + غير المرمز كمسافة وتتعذر قراءة القيمة)، أو تاريخ بمفرده (2026-10-01)، وهو ما يعني 00:00:00 UTC من ذلك اليوم. تُقرأ القيمة بدون إزاحة على أنها بتوقيت UTC. لا تُقبل القيم بأي تنسيق آخر.
تطابق لسلسلة فرعية غير حساس لحالة الأحرف في event_id أو action_type أو subject_vendor_data أو counterparty_vendor_data.
الاستجابة
صفحة واحدة من أحداث الشخص المعني.
صفحة واحدة من أحداث المراقبة، الأحدث في occurred_at أولاً.
عدد الأحداث المتطابقة، دقيق حتى 100 ويقتصر على 100 كحد أقصى بعد ذلك. لا تحسب عدد الصفحات بناءً عليه؛ اتبع next حتى تصبح null.
رابط URL للصفحة التالية، أو null في الصفحة الأخيرة.
رابط URL للصفحة السابقة، أو null في الصفحة الأولى.
Show child attributes
Show child attributes