跳转到主要内容
Didit 官方的 Python 库。它需要 Python 3.10 或更高版本,提供同步客户端 Didit 和异步客户端 AsyncDidit,两者方法相同。有关所有 SDK 共享的内容,请参阅服务端 SDK 概览。

安装

该软件包在 PyPI 上名为 didit-sdk。其源代码和变更日志位于 GitHub 上的 didit-protocol/sdk-python。 要验证 Authentication 令牌,请安装用于添加签名检查的额外依赖项:

配置客户端

Didit() 会从环境变量中读取 DIDIT_API_KEY。如需覆盖该设置,或设置应用范围调用(案件、网络、监管报告)所需的组织和应用 ID,请传入选项。

创建会话

为工作流创建验证会话,并引导用户访问其 URL。

读取决策

用户完成操作后(或 Webhook 到达时),读取决策。每个功能结果都是一个列表,每个工作流节点对应一个条目。

验证 Webhook

传入确切的原始请求体字节和请求头。对于任何无效或过期的投递,verify 都会抛出 WebhookVerificationError,因此只需捕获该类即可。
在 Flask 中为 handle_webhook(request.get_data(), dict(request.headers));在 FastAPI 中为 handle_webhook(await request.body(), request.headers)。轮换密钥期间,请同时传入两者:[new_secret, old_secret]。有关事件和签名方案,请参阅 Webhook。

筛查交易

将付款、提现或加密货币转账提交至交易监控;响应中包含其状态和风险评分。

验证 Authentication 令牌

didit.authentication 会在您的后端检查您的 Authentication 颁发方签名的访问令牌,无需为每个请求调用 Didit。它还可以交换代码、刷新令牌、检查和撤销会话,并运行升级验证。
令牌验证会针对您应用的颁发方和签名密钥,执行在服务器上验证令牌中列出的检查。

错误

列表、文件和异步

您可以在 API 参考的服务端 endpoint 页面中找到其操作的 Python 示例,但尚未在任何 1.0.1 版本中提供的端点和字段除外,它们列在概览中。
最后修改于 2026年11月7日