获取人脸比对url

简要描述

获取人脸比对url

请求地址

/v4/api/fdd/operateFaceAuthUrl

Header

参数名	必选	类型	说明
Token	是	string	应用令牌

请求参数

参数名	必选	类型	层级	说明	示例
customerId	是	string	1	客户编号	3E4B4CXXXX
idCard	是	string	1	身份证号	421125188888888888
personName	是	string	1	个人姓名	小青
notifyUrl	否	string	1	异步回调地址
returnUrl	否	string	1	同步回调地址
resultType	否	string	1	跳转类型 默认为2，参数值为“1”，人脸通过直接跳转return_url；人脸不通过停留在不通过原因页面；参数值为“2”，人脸无论是否通过，均停留在法大大页面；点击“完成认证”或“退出认证”跳转return_url；参数值为“3”，人脸无论是否通过，直接跳转return_url;仅对个人认证有效	2
transactionNo	否	string	1	个人认证交易号 该交易号需为未认证状态同时传姓名身份证和此交易号时法大大会以交易号中的信息为准

入参示例

{
  "customerId": "3E4B4CXXXX",
  "idCard": "421125188888888888",
  "personName": "小青",
  "notifyUrl": "https://xxx/notify",
  "returnUrl": "https://xxx/return",
  "resultType": "2"
}

返回参数

参数名	类型	层级	说明
code	int	1	状态码
msg	string	1	请求结果
total	int	1	返回总条数
requestId	string	1	请求编号
data	object	1	返回数据
transactionNo	string	2	个人认证交易号
faceAuthUrl	string	2	人脸认证url 两分钟内有效
status	string	2	认证状态 0：未激活；1：未认证；2：审核/认证通过；3：已提交待审核；4：审核不通过

成功返回示例

{
  "code": 200,
  "msg": "业务处理成功",
  "data": {
      "transactionNo": "FDDXXXXXXXXXXXXXXXXX",
      "faceAuthUrl": "https://xxx/faceAuth",
      "status": "1"
  },
  "total": null,
  "requestId": "ef1945c"
}

失败返回示例

{
  "code": 500,
  "msg": "业务处理失败",
  "data": null,
  "total": null,
  "requestId": "661df7a1"
}