Começar
Integrar / SDKs
Verificação de utilizadores
Verificação de empresas
Monitorização de transações
Registo de alteraçõescurl -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"
]
}Obter Evento de Monitorização API
Obtenha um evento de monitorização na Didit com payload, contexto do dispositivo, enriquecimento de IP, sinais em cache, etiquetas e evidências de regras.
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"
]
}Autorizações
A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.
Parâmetros de caminho
Identificador Didit do evento (event_uuid da resposta de criação, de processamento em lote, de listagem ou de cronologia), e não o seu próprio event_id.
Resposta
O evento com as suas provas.
Um evento de monitorização com o respetivo envelope completo, enriquecimento e evidência de regras. Todos os campos de MonitoringEvent mais os campos abaixo.
Identificador Didit do evento. Utilize-o como {event_uuid} nas chamadas de obtenção e eliminação.
O seu próprio identificador, a chave de idempotência que enviou.
128Categoria do evento.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom O que aconteceu dentro da categoria, tal como enviou.
128Quando o evento aconteceu do seu lado.
Quando a Didit aceitou o evento.
ACCEPTED: armazenado, nenhuma regra correspondida alterou o seu estado (a resposta normal para a maioria dos eventos, e sempre a resposta numa aplicação sandbox, onde não são executadas regras). APPROVED: uma regra correspondeu e a pontuação permaneceu abaixo do seu limiar de revisão. IN_REVIEW: uma regra elevou a pontuação acima do limiar de revisão ou definiu o estado. DECLINED: uma regra recusou-o ou a pontuação ultrapassou o seu limiar de recusa.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Pontuação acumulada da regra. Começa em 0; as ações add_score da regra alteram-na (são permitidos deltas negativos).
subject.vendor_data do evento: o seu ID para o utilizador ou empresa.
255individual ou company: que tipo de sujeito é indicado por subject_vendor_data.
"individual"
UUID do utilizador (indivíduo) ou empresa a que o evento foi associado, ou null quando esse registo já não existir.
O outro interveniente de um evento P2P (promovido a partir de payload.counterparty_vendor_data).
255session.session_id enviado com o evento.
255device_context.fingerprint enviado com o evento.
255Endereço IP do evento. Na via de servidor, este é o device_context.network_context.ip_address tal como o enviou; na via de dispositivo, é o IP do pedido.
64Código do país de ip_address a partir do enriquecimento de IP, ou null quando o endereço não foi enriquecido (em falta, privado ou telemetria de baixo valor cujo endereço ainda não era conhecido).
"ES"
Montante como uma string decimal com 18 casas decimais, a partir de transaction_context.amount, payload.amount ou payload.stake_amount, por essa ordem.
"250.000000000000000000"
Moeda de transaction_context.currency ou payload.currency.
10Promovido a partir de payload.game_id.
128Promovido a partir de payload.round_id.
128Promovido a partir de payload.bonus_id.
128Promovido a partir de payload.affiliate_code.
128Referência de pagamento de transaction_context.payment_reference_id ou payload.payment_reference_id.
255Classe de conservação. Os eventos de pagamento e de disputa são monetary_or_compliance; os eventos de segurança e de jogo responsável são risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed e affiliate.referral_clicked são low_value; todos os outros são standard. Um evento ao qual correspondeu uma regra ativa é promovido a risk_relevant (nunca despromovido).
low_value, standard, risk_relevant, monetary_or_compliance Número de regras que corresponderam ao evento, incluindo regras em modo TEST (que registam provas mas não aplicam ações).
x >= 0true enquanto uma regra assíncrona (correlação entre sujeitos ou uma sequência superior a 24 horas) ainda tem de ser executada para este evento. É resolvida em minutos e status, score e rules_matched_count são atualizados diretamente.
Se um SDK sob contrapressão pode descartar eventos deste tipo. false para todos os eventos de security, payment, dispute e responsible_gambling e para gameplay.bet_placed, gameplay.bet_settled e gameplay.p2p_settlement.
Os campos de categoria que enviou em payload.
Os custom_values escalares que enviou. A Didit adiciona vpn_or_proxy_detected: true ou is_data_center: true quando o enriquecimento de IP sinaliza o endereço e você não os definiu.
O contexto do dispositivo conforme armazenado: o seu device_context (incluindo fingerprint, persistent_device_id e bot_score quando enviados) com network_context completado por enriquecimento de IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) para chaves que tenha deixado vazias.
Caminho do campo até à proveniência: customer (enviado pelo seu backend), sdk (enviado através do canal do dispositivo) ou server (derivado pela Didit, como received_at e campos de rede enriquecidos). Verifique-o antes de agir sobre uma correspondência.
Show child attributes
Show child attributes
session.sequence enviado com o evento.
Promovido a partir de payload.table_id.
128Promovido a partir de payload.hand_id.
128Promovido a partir de payload.match_id.
128Promovido a partir de payload.market_id.
128Promovido a partir de payload.side.
64Promovido a partir de payload.role.
64Promovido a partir de payload.net_result_amount, como uma string decimal com 18 casas decimais.
"-120.000000000000000000"
Promovido a partir de payload.payment_fingerprint.
255Promovido a partir de payload.instrument_reference_hash.
255Promovido a partir de payload.withdrawal_address_hash (ou payload.destination_reference_hash).
255Promovido a partir de payload.dispute_id.
255Promovido a partir de payload.chargeback_id.
255Promovido a partir de payload.changed_field (eventos de alteração de segurança).
128Promovido a partir de payload.identity_match_ref (correspondências do registo de jogo responsável).
255Versão do esquema do envelope do evento. Atualmente 1.
1
Quando o evento expira de acordo com a sua classe de conservação e é eliminado: occurred_at mais o período da classe (14, 30 ou 90 dias por predefinição, ajustável por aplicação). Nulo para eventos monetary_or_compliance, que seguem a conservação de transações.
Número de regras de evento avaliadas para este evento.
x >= 0Cada regra que correspondeu ao evento, da mais recente para a mais antiga.
Show child attributes
Show child attributes
Enriquecimento do endereço IP do evento, ou null quando o endereço não foi enriquecido. Consulte Enriquecimento de IP.
Show child attributes
Show child attributes
Sinais de risco em cache de e-mail e telefone do sujeito, ou null se não existir qualquer perfil para o sujeito.
Show child attributes
Show child attributes
Nomes das etiquetas associadas ao evento (ações add_tags de regras).