在哪里可以找到 [AI39-1]外观防侵权检索-任务创建的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1ai~1infringement-detection-creation/post，也可在 /openapi.json 浏览完整规范。

[AI39-1]外观防侵权检索-任务创建

Q: [AI39-1]外观防侵权检索-任务创建 是什么？

用户须先查询[P060]专利图像检索-单图/[P061]专利图像检索-多图，得到相似专利结果，基于该结果请求接口 。必须参数：图像ulr（urls），相似专利信息（patent_messages），报告语言（report_lang），可选参数：受理局（country）。生成task_id，有效期为8小时，过期失效。

Q: [AI39-1]外观防侵权检索-任务创建 的接口地址是什么？

[AI39-1]外观防侵权检索-任务创建 的接口为 POST https://stage-connect.zhihuiya.com/ai/infringement-detection-creation。

Q: [AI39-1]外观防侵权检索-任务创建 可以返回哪些数据？

[AI39-1]外观防侵权检索-任务创建：用户须先查询[P060]专利图像检索-单图/[P061]专利图像检索-多图，得到相似专利结果，基于该结果请求接口 。必须参数：图像ulr（urls），相似专利信息（patent_messages），报告语言（report_lang），可选参数：受理局（country）。生成task_id，有效期为8小时，过期失效。。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://stage-connect.zhihuiya.com/ai/infringement-detection-creation

在体验中心中试用

用户须先查询[P060]专利图像检索-单图/[P061]专利图像检索-多图，得到相似专利结果，基于该结果请求接口。必须参数：图像ulr（urls），相似专利信息（patent_messages），报告语言（report_lang），可选参数：受理局（country）。生成task_id，有效期为8小时，过期失效。

1、相似专利信息，最多传100件相似专利信息 2、图像的URL，有效期为为9小时（32400秒）

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`country`	`array`	`[ "US", "EU", "CN" ]`	专利受理局（国家/组织/地区代码）输入国家代码进行检索结果筛选，国家代码请参照https://analytics.zhihuiya.com/status，可以多选，多个内容项之间用英文,隔开。
`patent_messages` 必填	`array`	`[ { "url": "http://patsnap-imagefulltext240.cdn.zhihuiya.com/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png", "apdt": 20190528, "apno": "EU006535076", "pbdt": 20190528, "score": 0.8884816, "title": "Mobile phones", "inventor": "ELSHAFIE, AHMED\|YANG, WEI\|HOSSEINI, SEYEDKIANOUSH", "loc_match": 1, "patent_id": "6e433449-143b-41d9-9abf-6c6519b07779", "patent_pn": "EU0065350760001S", "original_assignee": "HUAWEI TECHNOLOGIES CO., LTD." } ]`	相似专利信息,最多支持100条
`apdt`	`integer<int64>`	`20190528`	申请日
`apno`	`string`	`EU006535076`	申请号
`current_assignee`	`string`	`HUAWEI TECHNOLOGIES CO., LTD.`	当前申请人
`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时有效）
`original_assignee`	`string`	`HUAWEI TECHNOLOGIES CO., LTD.`	原始申请人
`patent_id` 必填	`string`	`6e433449-143b-41d9-9abf-6c6519b07779`	相似专利ID
`patent_pn` 必填	`string`	`EU0065350760001S`	相似专利号
`pbdt`	`integer<int64>`	`20190528`	公开日
`score`	`number`	`0.8884816`	相似度分数（仅当按照相似度排序时有效，即请求参数field为SCORE）
`title` 必填	`string`	`Mobile phones`	专利名称
`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`	相似的专利附图
`report_lang` 必填	`string`	`cn`	生成报告的语言(cn/en)
`urls` 必填	`array`	`[ "https://static-open.zhihuiya.com/sample/common_demo.png", "https://static-open.zhihuiya.com/sample/common_demo_2.png" ]`	图像的URL列表

{
  "urls": [
    "https://static-open.zhihuiya.com/sample/common_demo.png",
    "https://static-open.zhihuiya.com/sample/common_demo_2.png"
  ],
  "country": [
    "US",
    "EU",
    "CN"
  ],
  "report_lang": "cn",
  "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."
    }
  ]
}

响应结构

API 响应数据的结构说明

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

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "task_id": "80d440b7-80a5-4233-a75f-ab72b0885c88"
  },
  "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