시작하기
연동 / 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));모니터링 이벤트 조회 API
Didit에서 모니터링 이벤트 한 건의 페이로드, 기기 컨텍스트, 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));인증
Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.
경로 매개변수
자체 event_id가 아닌 이벤트의 Didit 식별자(생성, 일괄 처리, 목록 또는 타임라인 응답의 event_uuid)입니다.
응답
증거가 포함된 이벤트입니다.
전체 엔벨로프, 보강 정보 및 규칙 증거가 포함된 모니터링 이벤트 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이벤트의 주소입니다. 서버 레인에서는 전송된 device_context.network_context.ip_address이며, 기기 레인에서는 요청의 주소입니다.
64IP 보강을 통해 확인된 ip_address의 국가 코드이며, 주소가 보강되지 않은 경우(누락되었거나 사설 IP이거나 주소가 이미 알려져 있지 않은 저가치 텔레메트리인 경우) null입니다.
"ES"
transaction_context.amount, payload.amount, payload.stake_amount 순서대로 가져온 소수점 이하 18자리의 십진수 문자열 금액입니다.
"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 보강을 통해 주소에 플래그가 지정되었으나 직접 설정하지 않은 경우 Didit에서 vpn_or_proxy_detected: true 또는 is_data_center: true를 추가합니다.
저장된 기기 컨텍스트입니다. 전송 시의 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가 포함됩니다.
출처를 나타내는 필드 경로입니다. 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자리의 십진수 문자열입니다.
"-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
대상자의 캐시된 이메일 및 전화번호 위험 신호이며, 대상자의 프로필이 없는 경우 null입니다.
Show child attributes
Show child attributes
이벤트에 연결된 태그의 이름입니다(규칙의 add_tags 작업).