はじめに
連携 / 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 Management APIでモニタリングイベント1件を取得します。ペイロード、デバイス情報、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で取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys
パスパラメータ
イベントのDidit識別子（作成、一括、一覧、またはタイムラインのレスポンスに含まれるevent_uuid）で、独自のevent_idではありません。
レスポンス
証拠を含むイベントです。
完全なエンベロープ、エンリッチメント、ルールの根拠を含むモニタリングイベント1件。MonitoringEventのすべてのフィールドに加えて、以下のフィールドを含みます。
イベントのDidit識別子です。取得および削除の呼び出しで{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桁の10進数文字列で表した金額。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 >= 0このイベントについて非同期ルール（対象者をまたぐ相関、または24時間を超えるシーケンス）がまだ実行待ちの間はtrueです。数分以内に解決し、status、score、rules_matched_countがその場で更新されます。
バックプレッシャー下のSDKがこの種類のイベントを破棄してよいかどうかです。すべてのsecurity、payment、dispute、responsible_gamblingイベント、およびgameplay.bet_placed、gameplay.bet_settled、gameplay.p2p_settlementではfalseです。
payloadで送信したカテゴリのフィールド。
送信したスカラー値のcustom_valuesです。IPエンリッチメントでIPアドレスにフラグが付き、かつこれらの値を設定していない場合、Diditはvpn_or_proxy_detected: trueまたはis_data_center: trueを追加します。
保存されたデバイスコンテキストです。送信したdevice_context（送信した場合はfingerprint、persistent_device_id、bot_scoreを含む）に加え、空のままにしたキーについてはIPエンリッチメントで補完されたnetwork_context（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(received_atやエンリッチされたネットワークフィールドなど、Diditが導出)。一致に基づいて対応する前に確認してください。
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桁の10進数文字列です。
"-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アクション）。