HTML5（H5）版本的活体检测是一个重要的安全防范产品，可以在KYC过程中防止活体欺骗攻击。

该技术被应用于各种PC端和移动端应用中，以确保进行活体检测的是一个真实的人，而不是照片、视频、面具或其他形式的生物特征攻击。

活体检测H5产品，利用浏览器的能力，无需额外的插件或软件安装，即可无缝集成到在线平台中。它利用复杂的算法分析实时视频流中微妙的动作、纹理和其他体现活体真人的指标。

在整个过程中，终端用户需要根据提示做出相应动作，如“张嘴”或“眨眼”等。活体检测的结果可以从后端检索获取。如果检测到真人，会返回一张最佳的人脸自拍照片。

集成步骤

集成H5活体检测共有3个步骤：

1. 调用“获取Token API”，配置活体检测后的跳转页面URL和进行其他设置，接口返回Token和H5活体检测URL。
2. 用户通过上面产生的H5活体检测URL，完成活体检测全过程，跳转到相应的成功和失败页面URL。
3. 调用“获取结果API”在活体检测成功时获取最佳人脸自拍照，或在失败时接收详细原因。

1.获取Token API

Base URL

• Singapore：https://sg.apitd.net/verification/kyc/h5/liveness/token/v1
• Indonesia：https://id-credit.apitd.net/verification/kyc/h5/liveness/token/v1

API

认证参数

请求参数

响应参数

响应示例

• 业务请求

  JSON

  {
  	"success_redirect": "http://www.google.com",
  	"failure_redirect": "http://www.facebook.com",
  	"language": "en",
  	"audio": true
  }
  

• 业务请求成功

{
    "code": 200,
    "message": "success",
    "sequence_id": "17119500882*****29",
    "token": "a41701e4-b2a2-4f62-8cd4-9******3",
    "url": "https://static.tongdun.net/liveness/index.html#/progress?code=a41701e4-b2a2-4f62-8cd4-9******3&success_redirect=http%3A%2F%2Fwww.google.com&failure_redirect=http%3A%2F%2Fwww.facebook.com&language=en&audio=true&"
}

• 业务请求失败

{
    "code": 11350,
    "sequence_id": "69b57131b6fb********61ccba118b60",
    "message": "Internal error"
}

2.活体检测和页面跳转

活体完成之后，页面会自动跳转到客户配置的回调页面：成功页[successURL]或者失败页[failureURL]。
回调页面URL样例：
● 成功回调样例：[successURL]?code=7ac3a964-f540-4aa2-acdf-59ea1639572e&state=0
● 失败回调样例：[failureURL]?code=7ac3a964-f540-4aa2-acdf-59ea1639572e&state=2

当页面跳转后，客户回调页面接收到我们活体完成的参数state值为0或2时，就可以去调用获取结果API，查询活体检测结果。state值为非0或2的其他值时，详见以下解释和建议。

3.获取结果 API

Base URL

• Singapore：https://sg-s.apitd.net/verification/kyc/h5/liveness/result/v1
• Indonesia：https://id-credit.apitd.net/verification/kyc/h5/liveness/result/v1

API

认证参数

请求参数

响应参数

API 状态码

响应示例

• 业务请求

  JSON

  {
      "token":"a41701e4-b2a2-4f62-8cd4-9******3"
  }
  

• 业务请求成功

{
    "code": 200,
    "message": "Success",
    "sequence_id": "1711950327713613G109E0A081240931",
    "image": "/9j/4AAFbs64"
}

• 业务请求失败

{
    "code": 11350,
    "sequence_id": "69b57131b6fb********61ccba118b60",
    "message": "Internal error"
}