[P062]获取图像批量检索结果

post

https://connect.zhihuiya.com/search/patent/image-search/single-batch-result

根据[P062]生成图像批量检索任务接口返回的job_id 查询获取检索结果。

注意： 1、支持常用图像格式（jpg，png），文件小于4M。获得的相似图片路径有效期为9小时（32400秒），过期后会清空； 2、每张图最多支持返回100条相似专利结果，支持设置limit限制返回条数； 3、支持传入相似度阈值，返回相似度大于该阈值的相似专利列表，如果同时设置了limit，取两者的最小值条数返回； 4、计费规则：查得计费，根据上次图片成功返回结果；单价*成功返回结果的图片 5、如需使用本地图片检索，可以先调用【[P010]专利图像相似检索】接口上传图像，获得公网可以访问的Url 6、异步接口，图片检索于每日22：00~08：00执行任务；

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`task_id` 必填	`string`	`264de8bf7e294505a9a000597e25d615`	导出任务的ID

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`status`	`string`	`success`	节点状态，如success表示成功生成
`search_result`	`array`	`Please check the form: MoreImageSearchResult`	检索结果
`status`	`string`	`success`	执行状态
`search_url`	`string`	`https://static-open.zhihuiya.com/sample/common_demo.png`	url
`result_count`	`integer<int32>`	`100`	返回相似图片结果数
`patent_messages`	`array`	`Please check the form: PatentMessage`	相似专利信息
`url` 必填	`string`	`http://patsnap-imagefulltext240.cdn.zhihuiya.com/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99`	相似的专利附图
`apdt`	`integer<int64>`	`20190528`	申请日
`apno`	`string`	`EU006535076`	申请号
`pbdt`	`integer<int64>`	`20190528`	公开日
`score`	`number`	`0.8884816`	相似度分数（仅当按照相似度排序时有效，即请求参数field为SCORE）
`title` 必填	`string`	`Mobile phones`	专利名称
`img_id` 必填	`string`	`HDA0001130916580000011`	相似的专利附图img_id
`inventor`	`string`	`ELSHAFIE, AHMED\|YANG, WEI\|HOSSEINI, SEYEDKIANOUSH`	发明人
`loc_match`	`integer<int32>`	`1`	是否命中高权重LOC，1为命中，0为未命中（仅当model=1且field=SCORE时有效）
`patent_id` 必填	`string`	`6e433449-143b-41d9-9abf-6c6519b07779`	相似专利ID
`patent_pn` 必填	`string`	`EU0065350760001S`	相似专利号
`current_assignee`	`string`	`HUAWEI TECHNOLOGIES CO., LTD.`	当前申请人
`original_assignee`	`string`	`HUAWEI TECHNOLOGIES CO., LTD.`	原始申请人
`total_search_result_count`	`integer<int64>`	`100`	检索结果数
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "status": "success",
    "search_result": [
      {
        "status": "success",
        "search_url": "https://static-open.zhihuiya.com/sample/common_demo.png",
        "result_count": 100,
        "patent_messages": [
          {
            "url": "http://patsnap-imagefulltext240.cdn.zhihuiya.com/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99",
            "apdt": 20190528,
            "apno": "EU006535076",
            "pbdt": 20190528,
            "score": 0.8884816,
            "title": "Mobile phones",
            "img_id": "HDA0001130916580000011",
            "inventor": "ELSHAFIE, AHMED|YANG, WEI|HOSSEINI, SEYEDKIANOUSH",
            "loc_match": 1,
            "patent_id": "6e433449-143b-41d9-9abf-6c6519b07779",
            "patent_pn": "EU0065350760001S",
            "current_assignee": "HUAWEI TECHNOLOGIES CO., LTD.",
            "original_assignee": "HUAWEI TECHNOLOGIES CO., LTD."
          }
        ]
      }
    ],
    "total_search_result_count": 100
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码	描述
`68300004`	请求参数异常!
`68300005`	查询Api失败!
`68300006`	解析基本存取错误!
`68300007`	存在错误的请求!
`68300008`	服务中断异常，请稍后再试!
`68300010`	文件不符合上传规范!

平台错误码

错误码	描述
`67200000`	API整体限流错误!
`67200001`	API整体限流错误！
`67200002`	当前调用速率过快,超过当前配置限制QPS！
`67200003`	申请token的key和secret传参不正确或者客户端已被禁用！
`67200004`	请求的接口无权限请联系我们的支持人员！
`67200005`	账户余额/调用次数不足！
`67200006`	客户端超过开通有效期！
`67200007`	当前调用超过当天配置使用额度！
`67200008`	请检查query参数中必填的apikey是否传输！
`67200009`	apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
`67200012`	请求不合法！
`67200100`	当前服务器状态正忙,请求响应超时！
`67200101`	当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码	描述
`0`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms