ZOLOZZOLOZDOCS

enroll checkresult

重要说明：

  • 所有请求及返回参数均严格以官网API文档为准。
  • API返回结果中可能包含未在文档中定义的字段。这些字段仅供内部调试使用，不保证稳定性及兼容性，请勿在生产环境中依赖这些字段，ZOLOZ保留随时修改或删除这些字段的权利，且无需另行通知。

概览

  • API URL：/api/v1a/zoloz/smile/enroll/checkResult
  • API 描述：该接口用于获取基于SDK的人脸或掌纹采集流程的运行状态及其他相关结果。

请求参数

字段名称

数据类型

最大长度

是否必填

默认值

描述

示例值

bizId

String

32

是

-

业务ID，业务的唯一标识，用于追踪业务。例如，商户业务相关数据库中的序列号。

说明：ZOLOZ不校验该值的唯一性，商户侧需自行保证该业务ID的唯一性。

"2017839040588699"

transactionId

String

64

是

-

调用enroll initialize API返回的交易ID。

"G000000001FSE2025052300000001218988****"

返回参数

字段名称

数据类型

必须返回

描述

示例值

result

Result

是

API请求结果，包含结果状态、结果码和结果消息。

{

"resultStatus": "S",

"resultCode": "SUCCESS",

"resultMessage": "Success"

}

enrollResult

String

是

注册结果。

  • Success：注册成功
  • Failure：注册失败

"Success"

extFaceInfo

ExtEnrollFaceInfo

否

注册的人脸信息。仅当verificationType为face时返回。

{

"faceAttack": false

}

verificationType

String

是

生物特征验证类型。

  • palm：掌纹识别
  • face：人脸识别

"palm"

userId

String

是

用户ID。

"test_yyt_1"

twoFaInfo

String

否

二次验证信息。

"11111111111"

ExtEnrollFaceInfo字段说明

字段名称

数据类型

必须返回

描述

示例值

faceAttack

Boolean

否

是否检测到人脸攻击。

  • true：检测到人脸攻击。
  • false：未检测到人脸攻击。

false

处理结果

API通用结果码

有关通用结果码的完整列表，请参见API通用结果码。

API特有结果码

Smile enroll checkresult API的结果码见下表。

结果码

结果状态

描述

SUCCESS

S

API调用成功。

PROCESSING

F

正在处理中。

VERIFY_FAIL

F

生物特征验证失败。

NO_ACCOUNT_FOUND

F

未找到已注册的用户信息。

MULTIPLE_ACCOUNT_FOUND

F

检测到多个生物特征记录。

LIMIT_EXCEEDED

F

超过最大次数限制。

SYSTEM_ERROR

F

系统内部错误。有关错误详情，请查看返回的resultMessage。

代码示例

请求示例

copy
{
    "bizId": "2017839040588699",
    "transactionId": "G000000001FSE2025052300000001218988****"
}

返回示例

copy
{
    "result": {
        "resultStatus": "S", 
        "resultCode": "SUCCESS", 
        "resultMessage": "Success"
    }, 
    "extFaceInfo": {
        "faceAttack": false
    }, 
    "verificationType": "palm", 
    "twoFaInfo": "11111111111", 
    "userId": "test_yyt_1", 
    "enrollResult": "Success"
}