在哪里可以找到 [P062]生成图像批量检索任务的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1search~1patent~1image-search~1single-batch-create/post，也可在 /openapi.json 浏览完整规范。

[P062]生成图像批量检索任务

Q: [P062]生成图像批量检索任务 的接口地址是什么？

[P062]生成图像批量检索任务 的接口为 POST https://connect.zhihuiya.com/search/patent/image-search/single-batch-create。

Q: [P062]生成图像批量检索任务 可以返回哪些数据？

[P062]生成图像批量检索任务：支持批量上传多张产品图片（最多10个图）创建图像批量检索任务（检索结果同[P060]专利图像检索-单图），返回job_id。批量图像检索于每日22:00~08:00执行任务，在请求job_id的隔天8点后，根据job_id调用 [P062]获取图像批量检索结果（链接到对应接口页面网址） 接口获取检索结果。。完整响应结构请参见本页的响应结构与成功响应示例。

post

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

在体验中心中试用

支持批量上传多张产品图片（最多10个图）创建图像批量检索任务（检索结果同[P060]专利图像检索-单图），返回job_id。批量图像检索于每日22:00~08:00执行任务，在请求job_id的隔天8点后，根据job_id调用 [P062]获取图像批量检索结果（链接到对应接口页面网址）接口获取检索结果。

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

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`apply_end_time`	`string`	`20200101`	专利申请截止时间，格式:yyyyMMdd
`apply_start_time`	`string`	`20100101`	专利申请起始时间，格式:yyyyMMdd
`assignees`	`string`	`huawei`	申请（专利权）人
`country`	`array`	`[ "US", "EU", "CN" ]`	专利受理局（国家/组织/地区代码）输入国家代码进行检索结果筛选，国家代码请参照https://analytics.zhihuiya.com/status，可以多选，多个内容项之间用英文,隔开。
`field`	`string`	`SCORE`	返回结果排序field支持SCORE,APD,PBD,ISD SCORE：按照最相关排序 APD：按照申请日排序 PBD：按照公开日排序 ISD：按照授权日排序
`include_machine_translation`	`boolean`	`true`	搜索包含机器翻译数据
`is_https`	`integer<int32>`	-	选择是否返回https域名图片，默认为0，即返回http域名图片 1：返回https 0：返回http
`lang`	`string`	`original`	设置标题的语言优先选择，可以选cn、en、original，默认为original： original：专利原文标题 cn：专利中文翻译标题 en：专利英文翻译标题
`legal_status`	`string`	`3,2`	专利的法律状态 1:公开 2:实质审查 3:授权 8:避免重复授权 11:撤回 12:撤回-未指定类型 17:撤回-视为撤回 18:撤回-主动撤回 13:驳回 14:全部撤销 15:期限届满 16:未缴年费 21:权利恢复 22:权利终止 23:部分无效 24:申请终止 30:放弃 19:放弃-视为放弃 20:放弃-主动放弃 25:放弃-未指定类型 222:PCT未进入指定国（指定期内） 223:PCT进入指定国（指定期内） 224:PCT进入指定国（指定期满） 225:PCT未进入指定国（指定期满），可以多选，多个内容项之间用英文,隔开。
`limit`	`integer<int32>`	`10`	返回专利条数, 1 <= limit <= 100，默认为10
`loc`	`string`	`(14-03 OR 14-02)`	LOC分类(洛迦诺分类号)是针对外观设计专利的通用分类体系搜索任意层级的分类号，多个分类号可以用逻辑符AND/OR/NOT连接
`main_field`	`string`	`(phones or 手机)`	专利主要字段主要字段包括标题、摘要、权利要求、说明书、公开号、申请号、申请人、发明人和IPC/UPC/LOC分类号
`model` 必填	`integer<int32>`	`1`	选择图像检索模型（外观专利和实用新型有不同的模型可选）外观专利： 1：智能联想【推荐】 2：搜索此图实用新型专利： 3：匹配形状 4：匹配形状/图案/色彩【推荐】
`offset`	`integer<int32>`	-	偏移量，0 <= offset <= 1000，默认为0 如需要获取排名在100名之后的专利，可以设置offset=100
`order`	`string`	`desc`	当field选择APD,PBD,ISD时有效，order支持desc,asc。默认desc
`patent_type` 必填	`string`	`D`	选择检索外观专利或实用新型专利： D：外观专利 U：实用新型专利
`public_end_time`	`string`	`20200101`	专利公开截止时间，格式:yyyyMMdd
`public_start_time`	`string`	`20100101`	专利公开起始时间，格式:yyyyMMdd
`return_img_id`	`boolean`	-	是否返回img_id
`score_expansion`	`boolean`	`true`	分数拓展
`simple_legal_status`	`string`	`1,2`	专利的简单法律状态 0:失效 1:有效 2:审中 220:PCT指定期满 221:PCT指定期内 999:未确认，可以多选，多个内容项之间用英文,隔开。
`urls` 必填	`array`	`[ "https://static-open.zhihuiya.com/sample/common_demo.png" ]`	图像的URL列表，最多上传10条
`query_text`	`string`	`TACD: virtual reality`	请输入Analytics检索式
`stemming`	`integer<int32>`	-	是否开启截词功能，1：开启；0：关闭。默认关闭注：开启截词，在保留原词的同时，并扩展其对应的单复数及时态，例如搜索 "come"，会扩展为 "come", "comes", "came", "coming" 等等；关闭截词，只搜索检索式中关键词本身；在搜索语句中使用通配符，会影响截词在含通配符的关键词中生效；截词仅作用于英文关键词，且在申请人、发明人等涉及人名的字段中不起作用。
`pre_filter`	`integer<int32>`	`1`	是否开启前置国家/LOC过滤，1：开启；0：关闭。默认开启

请求示例

该 API 接口的请求体示例

JSON

{
  "loc": "(14-03 OR 14-02)",
  "lang": "original",
  "urls": [
    "https://static-open.zhihuiya.com/sample/common_demo.png"
  ],
  "field": "SCORE",
  "limit": 10,
  "model": 1,
  "order": "desc",
  "offset": 0,
  "country": [
    "US",
    "EU",
    "CN"
  ],
  "is_https": 0,
  "stemming": 0,
  "assignees": "huawei",
  "main_field": "(phones or 手机)",
  "pre_filter": 1,
  "query_text": "TACD: virtual reality",
  "patent_type": "D",
  "legal_status": "3,2",
  "return_img_id": false,
  "apply_end_time": "20200101",
  "public_end_time": "20200101",
  "score_expansion": true,
  "apply_start_time": "20100101",
  "public_start_time": "20100101",
  "simple_legal_status": "1,2",
  "include_machine_translation": true
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`job_id`	`string`	`1`	导出任务id
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "job_id": 1
  },
  "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