java.net.http、Jackson 和 JSpecify 可空性注解。每个方法都有一个 ...Async 变体,返回 CompletableFuture。各 SDK 的共同内容,请参阅服务端 SDK 概览。
安装
me.didit:didit-java。其源代码和变更日志位于 GitHub 上的 didit-protocol/sdk-java。
配置客户端
new Didit() 会从环境变量中读取 DIDIT_API_KEY。如需覆盖该值,或设置应用范围调用(案件、网络、监管报告)所需的组织和应用 ID,请使用构建器。
build() 会检查必填字段。可选的响应字段为 Optional 值;在 Kotlin 中,请使用 .getOrNull() 读取。本页以及每个 API 参考页面中的代码片段都是某个方法的方法体,所需的导入语句位于其上方。
创建会话
为某个工作流创建验证会话,并将您的用户引导至其 URL。读取决策
用户完成验证后(或 webhook 到达时),请读取决策。每个功能结果都是一个列表,每个工作流节点对应一项。验证 Webhook
传入原始请求体(保持接收时的原样)以及请求头。对于任何无效或已过期的投递,Webhooks.verify 都会抛出 WebhookVerificationException;否则返回类型化的事件。
@RequestBody byte[] body 接收请求体,以 @RequestHeader Map<String, String> headers 接收请求头。若在轮换一个密钥的同时需要接受两个密钥,请传入 VerifyOptions。事件和签名方案详见 Webhooks。
筛查交易
将支付、提现或加密货币转账提交至交易监控;响应中包含其状态和风险评分。验证 Authentication token
Authentication 会在您的后端检查您的 Authentication 签发方所签名的访问令牌,无需为每个请求调用 Didit。它还可以交换授权码、刷新 token、检查和撤销会话,以及执行升级验证。
token 验证会执行在服务器上验证令牌中的检查,针对您应用的签发方和签名密钥进行。
错误
每个异常都继承自非受检异常DiditException。