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/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 de cronologia de eventos do titular
Lista os eventos de monitorização de um utilizador ou empresa na Didit, do mais recente para o mais antigo, separando pessoas de empresas.
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
}
]
}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
O seu id para o sujeito (subject.vendor_data dos respetivos eventos). Codifique-o no URL; um valor contendo / não pode ser endereçado por este endpoint.
1 - 255Parâmetros de consulta
company devolve a empresa com este vendor_data; qualquer outro valor, ou nenhum, devolve o indivíduo. subject_entity_type é aceite como alias quando entity_type está ausente.
individual, company Número máximo de eventos por página. O valor predefinido é 50. Valores acima de 1000000 devolvem 400; um valor não numérico, zero ou negativo reverte para 50.
1 <= x <= 1000000Número de eventos a ignorar. A predefinição é 0. É preferível seguir o URL next da resposta.
0 <= x <= 1000000Apenas eventos nestas categorias. Repita o parâmetro para vários valores (?event_category=payment&event_category=dispute); é devolvido qualquer evento que corresponda a qualquer um deles.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Apenas eventos com estes tipos de ação (exatos, sensíveis a maiúsculas e minúsculas). Repita para vários valores.
Apenas eventos com estes estados. Repita para vários valores.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Apenas eventos nestas classes de conservação. Repita para vários valores.
low_value, standard, risk_relevant, monetary_or_compliance Correspondência exata no business.vendor_data enviado com o evento.
Correspondência exata em session.session_id.
Correspondência exata em device_context.fingerprint.
Correspondência exata no endereço IP do evento.
Correspondência exata no game_id promovido.
Correspondência exata no round_id promovido.
Correspondência exata no affiliate_code promovido.
Correspondência exata na referência de pagamento (de transaction_context.payment_reference_id ou payload.payment_reference_id).
Correspondência exata no counterparty_vendor_data promovido.
true (também 1 ou yes, não sensível a maiúsculas/minúsculas) devolve apenas eventos correspondidos por pelo menos uma regra (rules_matched_count superior a 0). Qualquer outro valor é ignorado.
Apenas eventos com occurred_at neste instante ou após o mesmo (inclusive). Envie um valor ISO 8601: 2026-10-01T00:00:00Z, um deslocamento explícito com o + codificado por percentagem (2026-10-01T02:00:00%2B02:00; um + não codificado é descodificado como um espaço e o valor deixa de ser analisado), ou apenas uma data (2026-10-01), o que significa 00:00:00 UTC desse dia. Um valor sem deslocamento é lido como UTC. Valores em qualquer outro formato não são aceites.
Apenas eventos com occurred_at neste instante ou antes do mesmo (inclusive). Uma data por si só significa o início desse dia, pelo que occurred_to=2026-10-15 exclui o resto de 15 de outubro; envie 2026-10-15T23:59:59Z para o incluir. Envie um valor ISO 8601: 2026-10-01T00:00:00Z, um deslocamento explícito com o + codificado por percentagem (2026-10-01T02:00:00%2B02:00; um + não codificado é descodificado como um espaço e o valor deixa de ser analisado), ou apenas uma data (2026-10-01), o que significa 00:00:00 UTC desse dia. Um valor sem deslocamento é lido como UTC. Valores em qualquer outro formato não são aceites.
Correspondência de subcadeia sem distinção entre maiúsculas e minúsculas em event_id, action_type, subject_vendor_data ou counterparty_vendor_data.
Resposta
Uma página de eventos do titular.
Uma página de eventos de monitorização, os eventos com o occurred_at mais recente primeiro.
Número de eventos correspondentes, exato até 100 e limitado a 100 acima disso. Não calcule contagens de páginas a partir dele; siga next até ser null.
URL da página seguinte, ou null na última página.
URL da página anterior, ou null na primeira página.
Show child attributes
Show child attributes