手持身份证比对

分析持有身份证的人和身份证照片是否属于同一人的可能性。使用我们的人脸匹配技术，您将得到我们对是否为同一人的判断以及相似度分数。

代码示例：

curl --location --request POST 'https://api.ekycpro.com/v1/idholding' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img=BASE64_ENCODE_VALUE'

相同人的响应示例

{
  "status": "OK",
  "message": {
    "similarity": 97.501,
    "result": "SAME PERSON"
  }
}

不同人的响应示例

{
  "status": "OK",
  "message": {
    "similarity": 27.501,
    "result": "NOT SAME PERSON"
  }
}

错误请求的响应示例

{
  "status": "INVALID_REQUEST",
  "message": "error message"
}

上传的图像大小超过 2M 的响应示例

{
  "status": "IMAGE_INVALID_SIZE",
  "message": "image larger than 2M"
}

错误图像，非手持身份证图像的响应示例

{
  "status": "RETRY_LATER",
  "message": "error not id holding image"
}

服务器错误的响应示例

{
  "status": "INNER_ERROR",
  "message": "Inner error, please retry later"
}

HTTP 请求

POST https://api.ekycpro.com/v1/idholding

请求参数

参数	描述
img	string，Base64 编码的图像数据

响应格式

字段	描述
status	状态码
message	similarity: 相似度分数，0~100
result: 判断结果

状态码

状态码	描述
OK	charge，成功，message.similarity 包含相似度分数
RETRY_LATER	charge，无效的手持身份证图像
INVALID_REQUEST	free，无效的请求参数
IMAGE_INVALID_SIZE	free，图像大小超过 2M
INNER_ERROR	free，服务器错误