API开放平台
查询翻拍识别结果

TIP

# 查询翻拍识别结果

接口说明：查询照片翻拍识别的结果，针对每张照片返回其翻拍可能性，客户可设定阈值判断照片是否为翻拍。一般认为可能性>0.96为翻拍的照片。

请求方式： POST（HTTPS）
请求地址： https://{region}/api/piccheck/v2/searchRemakeImageRes/{clientid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
  "bizId": "5122096114208480004",
  "createTime":"2023-09-11 20:21:23"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
bizId VARCHAR(32) 是 照片提交入库时的业务ID。
createTime VARCHAR(19) 否 业务创建时间，为照片入库后调用翻拍识别的时间(与调用图片入库时间可能存在差异)，格式：yyyy-MM-dd HH:mm:ss。不传会查近30天的数据，传了会查创建时间前后三天内的数据

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
  "bizId": "7353688744959393539",
  "aiResults": [
    {
      "thirdImageId":"5122096114208480001",
      "url": "https://image.third.com/7570161533259730386/user_defined/6296816947687725256/202203/20220302153031473_4513adc0_CAMERA_21002005284.jpg",
      "possibility": 0.37
    }]
}

参数说明：

参数 类型 说明
bizId VARCHAR(32) 照片提交入库时的业务ID
result [] 一组照片里翻拍的判断结果
result.thirdImageId VARCHAR(100) 第三方图片唯一ID
result.url VARCHAR(200) 图片URL地址
result.possibility FLOAT 该张照片的翻拍可能性，为0到1之间的小数，数值越大，翻拍的可能性越大。值为-1时表示虚假照片识别(API)欠费

错误码：

错误码 描述 排查方法
1010501099 产品欠费 产品欠费
1010501033 参数非法,请按照文档传参 参数非法,请按照文档传参
1 其他原因失败，详细用return_msg描述 -

# 查询相同照片识别结果

接口说明：该接口实现批量查询相同照片的识别结果，建议第二天下午查询前一日的检测结果。

请求方式： POST（HTTPS）
请求地址： https://{region}/api/piccheck/v2/searchSameImageRes/{ clientid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "startTime":"2023-09-11 00:00:00",
  "endTime":"2023-09-13 23:59:59",
  "page":1,
  "rows":10
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
startTime VARCHAR(19) 是 查询起始时间（包含），为照片入库后调用相同照片识别能力的时间(与调用图片入库接口可能有几秒的差异)。格式：yyyy-MM-dd HH:mm:ss
endTime VARCHAR(19) 是 查询结束时间（包含），为照片入库后调用相同照片识别能力的时间(与调用图片入库接口可能有几秒的差异)。格式：yyyy-MM-dd HH:mm:ss
page INT 是 分页页码
rows INT 是 分页大小

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[{
  "thirdImageId":"5122096114208480001",
  "hostImageUrl": "https://image.third.com/7570161533259730386/user_defined/6296816947687725256/202203/20220302153031473_342apm0_CAMERA_22319864284.jpg",
  "sameList": [
    {
      "thirdImageId":"5122096114208480002",
      "url": "https://image.third.com/7570161533259730386/user_defined/6296816947687725256/202203/20220302153031473_4513adc0_CAMERA_21002005284.jpg",
    }]
}]

参数说明：

参数 类型 说明
thirdImageId VARCHAR(100) 第三方主照片唯一ID
hostImageUrl VARCHAR(200) 主照片url
sameList [] 该主照片的相同照片列表
sameList.thirdImageId VARCHAR(100) 第三方相同照片唯一ID
sameList.url VARCHAR(200) 相同照片url

错误码：

错误码 描述 排查方法
1010501099 产品欠费 产品欠费
1010501033 参数非法,请按照文档传参 参数非法,请按照文档传参
1 其他原因失败，详细用return_msg描述 -

← 查询窜拍照片识别结果 →