शुरू करें
इंटीग्रेट करें / SDK
उपयोगकर्ता सत्यापन
व्यवसाय सत्यापन
लेन-देन निगरानी
चेंजलॉग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 कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।
पथ पैरामीटर
इवेंट का Didit पहचानकर्ता (create, batch, list या timeline रिस्पॉन्स से event_uuid), आपकी अपनी event_id नहीं।
प्रतिक्रिया
इवेंट अपने साक्ष्य के साथ।
अपने पूर्ण लिफ़ाफ़े, संवर्धन और नियम साक्ष्य के साथ एक निगरानी इवेंट। MonitoringEvent का प्रत्येक फ़ील्ड और नीचे दिए गए फ़ील्ड।
इवेंट का Didit पहचानकर्ता। retrieve और delete कॉल में इसका उपयोग {event_uuid} के रूप में करें।
आपका अपना पहचानकर्ता, आपके द्वारा भेजी गई आइडेम्पोटेंसी कुंजी।
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: उपयोगकर्ता या कंपनी के लिए आपकी id।
255individual या company: subject_vendor_data किस प्रकार के विषय का नाम निर्दिष्ट करता है।
"individual"
उस उपयोगकर्ता (व्यक्ति) या कंपनी का UUID जिससे इवेंट संबद्ध हुआ, या वह रिकॉर्ड अब मौजूद न होने पर null।
P2P इवेंट का अन्य पक्ष (payload.counterparty_vendor_data से प्रमोट किया गया)।
255इवेंट के साथ भेजा गया session.session_id।
255इवेंट के साथ भेजा गया device_context.fingerprint।
255इवेंट का IP पता। सर्वर लेन पर यह device_context.network_context.ip_address होता है जैसा आपने भेजा था; डिवाइस लेन पर यह अनुरोध का IP होता है।
64IP संवर्धन से ip_address का देश कोड, या पता संवर्धित न होने पर null (अनुपलब्ध, निजी, या कम मूल्य वाला टेलीमेट्री जिसका पता पहले से ज्ञात नहीं था)।
"ES"
18 दशमलव स्थानों के साथ दशमलव स्ट्रिंग के रूप में राशि, इसी क्रम में transaction_context.amount, payload.amount या payload.stake_amount से।
"250.000000000000000000"
transaction_context.currency या payload.currency से प्राप्त मुद्रा।
10payload.game_id से प्रमोट किया गया।
128payload.round_id से प्रमोट किया गया।
128payload.bonus_id से प्रमोट किया गया।
128payload.affiliate_code से प्रमोट किया गया।
128transaction_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 >= 0true जब तक इस इवेंट के लिए कोई एसिंक्रोनस नियम (क्रॉस-सब्जेक्ट सहसंबंध, या 24 घंटे से अधिक का अनुक्रम) चलना बाकी हो। यह कुछ मिनटों के भीतर हल हो जाता है और status, score तथा rules_matched_count उसी स्थान पर अपडेट हो जाते हैं।
क्या बैकप्रेशर के तहत SDK इस प्रकार के इवेंट को ड्रॉप कर सकता है। प्रत्येक security, payment, dispute और responsible_gambling इवेंट के लिए और gameplay.bet_placed, gameplay.bet_settled तथा gameplay.p2p_settlement के लिए false।
वे श्रेणी फ़ील्ड जो आपने payload में भेजे हैं।
आपके द्वारा भेजे गए स्केलर custom_values। Didit vpn_or_proxy_detected: true या is_data_center: true जोड़ता है जब IP संवर्धन पते को फ़्लैग करता है और आपने उन्हें सेट नहीं किया है।
स्टोर किया गया डिवाइस संदर्भ: आपका device_context (भेजे जाने पर fingerprint, persistent_device_id और bot_score सहित), जिसमें आपके द्वारा खाली छोड़ी गई कुंजियों के लिए IP एनरिचमेंट (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) द्वारा network_context को पूरा किया गया है।
मूल स्रोत (provenance) का फ़ील्ड पथ: customer (आपके बैकएंड द्वारा भेजा गया), sdk (डिवाइस लेन के माध्यम से भेजा गया) या server (Didit द्वारा व्युत्पन्न, जैसे कि received_at और संवर्धित नेटवर्क फ़ील्ड)। किसी मिलान पर कार्रवाई करने से पहले इसे जांचें।
Show child attributes
Show child attributes
इवेंट के साथ भेजा गया session.sequence।
payload.table_id से प्रमोट किया गया।
128payload.hand_id से प्रमोट किया गया।
128payload.match_id से प्रमोट किया गया।
128payload.market_id से प्रमोट किया गया।
128payload.side से प्रमोट किया गया।
64payload.role से प्रमोट किया गया।
64payload.net_result_amount से प्रमोट किया गया, 18 दशमलव स्थानों वाली दशमलव स्ट्रिंग के रूप में।
"-120.000000000000000000"
payload.payment_fingerprint से प्रमोट किया गया।
255payload.instrument_reference_hash से प्रमोट किया गया।
255payload.withdrawal_address_hash (या payload.destination_reference_hash) से प्रमोट किया गया।
255payload.dispute_id से प्रमोट किया गया।
255payload.chargeback_id से प्रमोट किया गया।
255payload.changed_field से प्रमोट किया गया (सुरक्षा परिवर्तन इवेंट)।
128payload.identity_match_ref से प्रमोट किया गया (जिम्मेदार-जुआ रजिस्ट्री मिलान)।
255इवेंट एनवेलप स्कीमा का संस्करण। वर्तमान में 1।
1
जब इवेंट अपनी प्रतिधारण श्रेणी के तहत समाप्त हो जाता है और हटा दिया जाता है: occurred_at और साथ में श्रेणी अवधि (डिफ़ॉल्ट रूप से 14, 30 या 90 दिन, प्रति एप्लिकेशन समायोज्य)। monetary_or_compliance इवेंट के लिए Null, जो लेन-देन प्रतिधारण का पालन करते हैं।
इस इवेंट के लिए मूल्यांकित इवेंट नियमों की संख्या।
x >= 0प्रत्येक नियम जो इवेंट से मेल खाता है, सबसे नया पहले।
Show child attributes
Show child attributes
इवेंट के IP पते का संवर्धन, या पता संवर्धित न होने पर null। देखें IP संवर्धन।
Show child attributes
Show child attributes
विषय के कैश्ड ईमेल और फ़ोन जोखिम संकेत, या विषय के लिए कोई प्रोफ़ाइल मौजूद न होने पर null।
Show child attributes
Show child attributes
इवेंट से जुड़े टैग्स के नाम (नियम add_tags कार्रवाइयाँ)।