Python
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.fraud_checks.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.fraudChecks.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.FraudChecks.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.fraudChecks().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->fraudChecks->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.fraud_checks.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.FraudChecks.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));curl --request GET \
--url https://verification.didit.me/v3/fraud/checks/{check_id}/ \
--header 'x-api-key: <api-key>'{
"check_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_reference": "<string>",
"processing_status": "pending",
"profile_id": "<string>",
"profile_version": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"inputs": [
{
"reference": "<string>",
"type": "email",
"namespace": {},
"quality": "<string>",
"normalization": {},
"availability": "available"
}
],
"modules": [
{
"module": "normalization",
"status": "planned",
"reason": "<string>",
"latency_ms": 123,
"freshness": "<string>",
"billable_units": 123
}
],
"attribute_evidence": [
{}
],
"compound_evidence": [
{}
],
"risk": [
{
"dimension": "identity",
"score": 123,
"band": "low",
"availability": "available",
"requested_but_unavailable": true,
"reason_codes": [
"<string>"
],
"evidence_indexes": [
123
]
}
],
"network": {},
"recommendation": "approve",
"next_action": "none",
"decision_reasons": [
"<string>"
],
"coverage": {},
"usage": [
{}
],
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"enrichment": {},
"identity_relationship": {
"result": "match",
"reference_type": "<string>",
"country": "<string>",
"availability": "available",
"reason_codes": [
"<string>"
]
},
"vendor_data": "<string>",
"metadata": null
}{
"detail": "Authentication failed: Invalid client access token."
}{
"detail": "Forbidden - User doesn't have permission"
}合规与风险
获取欺诈检测结果
在 Didit 中检索您应用内某次欺诈检测(Fraud Check)已存储的结果。该检测须属于您的应用,接口仅返回这一已存储的结果。
GET
/
v3
/
fraud
/
checks
/
{check_id}
/
Python
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.fraud_checks.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.fraudChecks.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.FraudChecks.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.fraudChecks().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->fraudChecks->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.fraud_checks.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.FraudChecks.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));curl --request GET \
--url https://verification.didit.me/v3/fraud/checks/{check_id}/ \
--header 'x-api-key: <api-key>'{
"check_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_reference": "<string>",
"processing_status": "pending",
"profile_id": "<string>",
"profile_version": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"inputs": [
{
"reference": "<string>",
"type": "email",
"namespace": {},
"quality": "<string>",
"normalization": {},
"availability": "available"
}
],
"modules": [
{
"module": "normalization",
"status": "planned",
"reason": "<string>",
"latency_ms": 123,
"freshness": "<string>",
"billable_units": 123
}
],
"attribute_evidence": [
{}
],
"compound_evidence": [
{}
],
"risk": [
{
"dimension": "identity",
"score": 123,
"band": "low",
"availability": "available",
"requested_but_unavailable": true,
"reason_codes": [
"<string>"
],
"evidence_indexes": [
123
]
}
],
"network": {},
"recommendation": "approve",
"next_action": "none",
"decision_reasons": [
"<string>"
],
"coverage": {},
"usage": [
{}
],
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"enrichment": {},
"identity_relationship": {
"result": "match",
"reference_type": "<string>",
"country": "<string>",
"availability": "available",
"reason_codes": [
"<string>"
]
},
"vendor_data": "<string>",
"metadata": null
}{
"detail": "Authentication failed: Invalid client access token."
}{
"detail": "Forbidden - User doesn't have permission"
}使用同一应用的凭证检索已完成的检查。
响应是已存储的执行结果;检索不会重新运行检查,也不会产生额外费用。
当前的共享访问权限适用于全球网络证据:撤销访问权限后,共享聚合数据及其派生的风险证据将被隐藏。
历史建议会被保留。
未知、未完成或已删除的检查返回
404。
属于其他应用的检查同样返回 404。授权
ApiKeyAuthBearerAuth
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
路径参数
响应
pending- 等待中running- 运行中completed- 已完成failed- 失败
可用选项:
pending, running, completed, failed Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
approve- 通过review- 审核reject- 拒绝
可用选项:
approve, review, reject none- 无manual_review- 人工审核step_up- 强化验证resubmit_capture- 重新提交采集
可用选项:
none, manual_review, step_up, resubmit_capture Show child attributes
Show child attributes
Show child attributes
Show child attributes
为此检查创建的原生验证会话。
Show child attributes
Show child attributes
Show child attributes
Show child attributes
最后修改于 2026年11月7日