WIDTH Identity 开发者文档

WIDTH Identity 提供完整的身份核验与合规平台,覆盖 KYC、KYB、交易筛查与持续监控全流程 — 通过 REST API 与适配 Web、iOS、Android 的 SDK 接入。

核心能力

平台提供四类核心合规工作流。每类均可通过 REST API 调用,大部分同时支持 SDK 接入。

集成方式

提供三种集成方式。需要完整后端控制时使用 OpenAPI;希望快速获得托管核验体验时使用 SDK。

环境

提供两套环境:用于开发的 staging(测试环境)与承载真实流量的 production(生产环境)。所有 staging URL 以 -stg 结尾。

凭证

根据集成方式不同,提供两类凭证。

如何获取

1. 登录 One Platform Console → API & Integration。
2. 点击 Generate 生成密钥对。
3. 复制并安全保存凭证。apiSecret 仅显示一次。

快速开始 — 请求签名

每个 OpenAPI 请求都使用 HMAC-SHA256 对请求体进行签名,签名通过 sign 查询参数附加传递。

sign = HmacSHA256(apiSecret, requestBody)

密钥与请求体均使用 UTF-8 编码,签名结果为 64 位小写十六进制字符串。

import hmac, hashlib

sign = hmac.new(
    api_secret.encode('utf-8'),
    request_body.encode('utf-8'),
    hashlib.sha256
).hexdigest()

const crypto = require('crypto');

const sign = crypto
  .createHmac('sha256', apiSecret)
  .update(requestBody, 'utf8')
  .digest('hex');

Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(apiSecret.getBytes("UTF-8"), "HmacSHA256"));
byte[] hash = mac.doFinal(requestBody.getBytes("UTF-8"));
String sign = HexFormat.of().formatHex(hash);

请参阅 身份验证参考 获取完整请求信封,包括请求头、查询参数与示例。

下一步:选择一个工作流