ZOLOZZOLOZDOCS

asynccompare

概览

  • API URL：/api/v1/zoloz/facecompare/asynccompare
  • API 描述：该接口用于初始化异步人脸比对请求。当您需要大量调用compare API时，为了避免因网络波动而导致响应超时，建议使用asynccompare API。在API调用结束后，您可以通过asynccheckresult API异步获取人脸比对结果。

请求参数

字段名称

数据类型

最大长度

是否必填

默认值

描述

示例值

bizId

String

32B

是

-

业务ID，业务的唯一标识，用于追踪业务。

"trans-test-1234"

userId

String

64B

否

null

商户的用户ID或其他可用于识别某一用户的标识，例如手机号码、电子邮件地址等。

建议对userId字段的值进行预脱敏，例如进行哈希处理。

"userid_1234"

face1.content

String

5MB

是

-

采用Base64编码的人脸图片，该图片支持JPG、JPEG、PNG、BMP格式。

注意：

  • face1.content和face2.content两张图片的总大小不能超过5MB，如果图片过大，建议压缩后再上传，以免造成系统错误。
  • 该参数默认需传入活体人脸图片，如果您传入的是证件脸图片，将无法保证识别结果的准确性。

"/9j/4AA..[omitted]..PxA="

face1.rect

String

32B

否

null

人脸坐标，格式为“左、上、宽、高”。

"234,54,22,123"

face2.content

String

5MB

是

-

采用Base64编码的人脸图片，该图片支持JPG、JPEG、PNG、BMP格式。

注意：face1.content和face2.content两张图片的总大小不能超过5MB，如果图片过大，建议压缩后再上传，以免造成系统错误。

"/9j/4AA..[omitted]..tvq="

face2.rect

String

32B

否

null

人脸坐标，格式为“左、上、宽、高”。

"234,432,34,22"

sourceOfFace2

String

32B

否

SELFIE

指定face2.content是活体人脸图片还是证件脸图片。取值如下：

说明：如果face2.content的类型与该字段传入的值不一致，会导致人脸比对结果不准确。

"SELFIE"

返回参数

字段名称

数据类型

必须返回

描述

示例值

result

Result

是

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

{

"resultCode": "PROCESSING",

"resultStatus": "S",

"resultMessage": "It is still under processing"

}

transactionId

String

是

事务ID。

"G000000005FID2020030400000000000157****"

Result字段说明

字段名称

数据类型

必须返回

描述

示例值

resultCode

String

是

结果码。

  • INVALID_ARGUMENT：输入参数无效。
    • bizId为null或空字符串。
    • face1或face2的内容为空，或编码格式不正确。
  • PROCESSING：正在处理中。
  • SYSTEM_ERROR：其他内部错误。

"PROCESSING"

resultStatus

String

是

结果状态。

"S"

resultMessage

String

是

结果信息。

"It is still under processing"

代码示例

请求示例

copy
POST /api/v1/zoloz/facecompare/asynccompare HTTP/1.1
Content-Type: application/json; charset=UTF-8
Client-Id: 5X67656YXXXXXX
Request-Time: 2024-01-04T12:08:56+05:30
Signature: algorithm=RSA256, signature=xxxxxxxxxxxx

{
  "bizId": "trans-test-1234",
  "userId":"userid_1234",
  "face1": {
    "content": "/9j/4AA..[omitted]..PxA=",
    "rect": "234,54,22,123"
  },
  "face2": {
    "content": "/9j/4AA..[omitted]..tvq=",
    "rect": "234,432,34,22"
  },
  "sourceOfFace2": "SELFIE"
}

返回示例

copy
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Response-Time: 2024-01-19T21:56:15-0800
Signature: algorithm=RSA256, signature=xxxxxxxxxxxxxxxxxx

{
  "transactionId": "G000000005FID2020030400000000000157****",
  "result": {
    "resultCode":"PROCESSING",
    "resultStatus":"S",
    "resultMessage":"It is still under processing"
  }
}