Начало работы
Интеграция / 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: 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));Авторизации
API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.
Параметры пути
Идентификатор события в Didit (event_uuid из ответа методов create, batch, list или timeline), а не ваш собственный event_id.
Ответ
Событие с его свидетельствами.
Одно событие мониторинга с полной оболочкой, обогащёнными данными и подтверждениями правил. Все поля 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 события: ваш идентификатор пользователя или компании.
255individual или company: к какому типу субъекта относится subject_vendor_data.
"individual"
UUID пользователя (физического лица) или компании, к которым относится событие, либо null, если эта запись больше не существует.
Второй участник P2P-события (перенесено из payload.counterparty_vendor_data).
255session.session_id, переданный с событием.
255device_context.fingerprint, отправленный с событием.
255IP-адрес события. В серверном канале это переданный вами device_context.network_context.ip_address; в клиентском канале устройства это IP-адрес запроса.
64Код страны ip_address, полученный в результате обогащения данных IP, или null, если адрес не был обогащён (отсутствует, приватный или малозначимые данные телеметрии, адрес которых ранее не был известен).
"ES"
Сумма в виде десятичной строки с 18 знаками после запятой, из transaction_context.amount, payload.amount или payload.stake_amount, в указанном порядке.
"250.000000000000000000"
Валюта из transaction_context.currency или payload.currency.
10Перенесено из payload.game_id.
128Перенесено из payload.round_id.
128Перенесено из payload.bonus_id.
128Перенесено из payload.affiliate_code.
128Идентификатор платежа из transaction_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 при обратном давлении (backpressure) отбрасывать события этого типа. Значение false для каждого события security, payment, dispute и responsible_gambling, а также для gameplay.bet_placed, gameplay.bet_settled и gameplay.p2p_settlement.
Поля категории, которые вы отправили в payload.
Переданные вами скалярные custom_values. Didit добавляет vpn_or_proxy_detected: true или is_data_center: true, если обогащение данных по IP отмечает адрес флагом, а вы их не задали.
Контекст устройства в сохранённом виде: ваш device_context (включая fingerprint, persistent_device_id и bot_score, если они были переданы) с network_context, дополненным обогащением по IP (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 (сгенерировано Didit, например received_at и обогащённые сетевые поля). Проверьте его перед обработкой совпадения.
Show child attributes
Show child attributes
session.sequence, переданный с событием.
Перенесено из payload.table_id.
128Перенесено из payload.hand_id.
128Перенесено из payload.match_id.
128Перенесено из payload.market_id.
128Перенесено из payload.side.
64Перенесено из payload.role.
64Перенесено из payload.net_result_amount, в виде десятичной строки с 18 знаками после запятой.
"-120.000000000000000000"
Перенесено из payload.payment_fingerprint.
255Перенесено из payload.instrument_reference_hash.
255Перенесено из payload.withdrawal_address_hash (или payload.destination_reference_hash).
255Перенесено из payload.dispute_id.
255Перенесено из payload.chargeback_id.
255Перенесено из payload.changed_field (события изменения безопасности).
128Перенесено из payload.identity_match_ref (совпадения в реестрах ответственной азартной игры).
255Версия схемы конверта события. В настоящее время 1.
1
Когда срок хранения события по его классу хранения истекает и оно удаляется: occurred_at плюс период класса (14, 30 или 90 дней по умолчанию, настраивается для каждого приложения). Null для событий monetary_or_compliance, для которых действует срок хранения транзакций.
Количество правил событий, проверенных для этого события.
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).