人脸识别.md

人脸识别接口文档

供商户进行用户身份识别，验证用户身份信息和当前操作用户是同一人。

签名和验签方式请参考API文档

查询用户识别信息

GET /v1/face/auth/{userId} HTTP/1.1
Host: https://www.paymax.cc/merchant-api
ContentType: application/json;charset=utf-8
Authorization: {填入Secret Key}
nonce: {填入nonce随机字符串}
timestamp: {填入timestamp}
sign: {填入签名结果}	

userId：字符型，用户在商户系统的唯一标识。

返回：

字段	类型	描述
authValid	boolean	用户是否已进行人脸识别 true:已识别，false：未识别

响应错误码

当调用API接口失败时，会返回一个json对象，标明失败的原因和具体描述。

例如：

{
  "failure_code": "SECRET_KEY_IS_BLANK",
  "failure_msg": "SecretKey为空"
}

• failure_code是对失败原因的唯一标识，failure_msg是对失败原因的进一步的解释和描述

• 对于同一种failure_code，可能会有多种failure_msg。

详细的错误代码表及示例：

错误码(failure_code)	描述示例(failure_msg)	说明
SECRET_KEY_IS_BLANK	SecretKey为空
SECRET_KEY_IS_INVALID	非法的SecretKey
SIGN_CHECK_FAILED	签名校验失败	签名校验的原因
USER_FACE_NOT_AUTH	用户未进行人脸识别	仅针对开通人脸识别且支付渠道为拉卡拉移动 SDK,会进行人脸识别限制
ILLEGAL_ARGUMENT	参数错误	调用接口的参数错误
SYSTEM_ERROR	系统内部错误	由于某些原因造成系统处理异常，请联系Paymax处理