服务端开发文档
更新时间：2026-07-23 19:05:12
| 日期 | 版本 | 修订内容摘要 |
|---|---|---|
| 2023-08-18 | v2.0.0 | 更新接口文档 |
• 接⼝名称：活体检测结果查询
• URL: https://api.253.com/sdk/liveSDK/livingDetection
• Content-Type: application/x-www-form-urlencoded
• Method：POST
• 请求参数说明
| 字段名称 | 字段说明 | 字段类型 | 是否必填 |
|---|---|---|---|
| certifyId | sdk 活体认证标识 | string | 是 |
| timeStamp | 时间戳 （13 位 long 字符串类型） | string | 是 |
| sign | 签名 | string | 是 |
注意：sign ⽣成为 参数⽣成 MD5(certifyId 值+参数 timeStamp 值+应⽤ appkey) 转⼩写
注意：appkey 必须是 certifyId 对应的应⽤ appId
• 请求成功-结果⽰例
{
"message": "请求成功",
"code": "200000",
"data": {
"passed": "T",
"material_matched": "T"
}
}• 返回结果说明
| 字段名称 | 字段说明 | 字段类型 |
|---|---|---|
| code | 响应 code 码。200000：成功，其他失败 | string |
| msg | code 码描述 | string |
| data | 数据结果 | Object |
| data>> passed | 认证是否通过(T、F 或 null) | String |
| data>> material_matched | 认证材料哈希是否匹配(T、F 或 null) ，当前字段在 活体识别中 可以⽆需判断 以 passed 字段判断为主 |
• 错误码描述
| 错误码 | 错误描述 |
|---|---|
| 200000 | 成功 |
| 400001 | 参数校验异常 |
| 500003 | 业务类型不匹配 |
| 500005 | 账⼾余额不⾜ |
| 500006 | 请求外部系统失败 |
| 600005 | 签名校验失败 |
| 600010 | certifyId 不匹配 或已使⽤ |
| 600011 | 应⽤信息不匹配 |
| 600019 | 应⽤信息校验异常 |
| 500000 | 系统异常 |
这篇文档对您有帮助吗？
