跳到主要内容

Device Validation 对象

通过唯一标识进行设备验证应通过 Event Type Device Validation 端点完成。发送的数据应为设备注册 API 生成的数据,以及一个 Device Scan 会话 ID。也就是说,要执行设备验证,应用程序必须使用 SDK 生成唯一标识符,并完成设备注册,以便后续识别该设备。

状态动态 - analysis_status

analysis_status 状态表示欺诈引擎决策的状态,具有简单的状态机:

  • automatically_approved
  • automatically_reproved
  • in_manual_analysis
  • manually_approved
  • manually_reproved
  • pending

Device Validation 对象定义

Request Body
{
"id": "12345678",
"account_id": "12345678",
"person_id": "12345678",
"session_id": "12345678",
"event_date": "2019-12-11T11:37:15.12-03:00"
}

设备验证的所有信息交换均使用以下对象定义。在某些情况下,为了便于实现并减少各方之间的数据流,部分信息可能会被省略。

名称类型描述
idstring事件标识符。
此编号对每个请求必须唯一 (必填)
account_idstring设备注册系统中已注册账户的标识符。若要对同一注册进行多次分析,只需在不同分析中使用相同的 account_id。(必填)
person_idstring设备注册系统中与已注册账户关联的用户标识符。若要对同一注册进行多次分析,只需在不同分析中使用相同的 person_id。(必填)
session_idstringDevice Scan 分析会话的标识符。(必填)
face_recognition_keystringSDK 生成的用于面部识别的图像标识符。
event_datedatetime事件的日期和时间 (必填)

发送 Device Validation

Request Body
  {
"id": "12345",
...
}
Response Body
  {
"id": "12345",
"analysis_status": "automatically_approved",
"reason": "rule_decision_enum"
}

要执行设备验证,只需将 Device Validation 类型的对象发送到以下端点:

POST https://api.caas.qitech.app/account_event/event_type/device_validation/event