在哪里可以找到 [R004-1]技术想法查新-创建报告的 OpenAPI schema？

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

[R004-1]技术想法查新-创建报告

Q: [R004-1]技术想法查新-创建报告 是什么？

根据技术手段或者技术效果，创建技术想法查新报告，获取报告下载任务ID。 技术想法查新报告包含排查技术要点、排查范围、相似专利列表、对比文件详细对比（技术问题、技术手段、技术效果、相似特征对比、核心发明点、改进方向）、分析结果，技术监控建议。

Q: [R004-1]技术想法查新-创建报告 的接口地址是什么？

[R004-1]技术想法查新-创建报告 的接口为 POST https://connect.zhihuiya.com/search/patent/idea-validation/task/create。

Q: [R004-1]技术想法查新-创建报告 可以返回哪些数据？

[R004-1]技术想法查新-创建报告：根据技术手段或者技术效果，创建技术想法查新报告，获取报告下载任务ID。 技术想法查新报告包含排查技术要点、排查范围、相似专利列表、对比文件详细对比（技术问题、技术手段、技术效果、相似特征对比、核心发明点、改进方向）、分析结果，技术监控建议。。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://connect.zhihuiya.com/search/patent/idea-validation/task/create

在体验中心中试用

根据技术手段或者技术效果，创建技术想法查新报告，获取报告下载任务ID。技术想法查新报告包含排查技术要点、排查范围、相似专利列表、对比文件详细对比（技术问题、技术手段、技术效果、相似特征对比、核心发明点、改进方向）、分析结果，技术监控建议。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`country`	`array`	`[ "CN", "US", "KR" ]`	受理局，例如：CN，US，KR等，默认查询全部数据。
`legal_status`	`array`	`[ "失效", "有效", "审中", "PCT指定期满", "PCT指定期内", "未确认" ]`	简单法律状态，默认全选。枚举如下：失效、有效、审中、PCT指定期满、PCT指定期内、未确认
`limit`	`integer<int32>`	`5`	当前技术方案，从方案新颖性角度，最多返回Top20个可能相似的专利生成方案查新报告，默认选择根据相似度排序Top5条的专利
`tech_effect`	`string`	`实现了车辆的原地掉头`	技术效果（最少不少于10个字，最多不超过2000个字）
`tech_means` 必填	`string`	原地转向控制系统利用车辆控制器根据接收到的原地转向指令控制左转向电机控制器和所述右转向电机控制器，左转向电机控制器根据接收到的原地转向指令控制左前轮转向，右转向电机控制器根据接收到的原地转向控制指令控制右前轮转向，且左前轮和右前轮的转动方向相反使得左前轮和右前轮之间形成预设角度的“内八字”，由转动电机控制向车辆控制器发送转向完成指令。	技术手段（最少不少于50个字，最多不超过2000个字）

请求示例

该 API 接口的请求体示例

JSON

{
  "limit": 5,
  "country": [
    "CN",
    "US",
    "KR"
  ],
  "tech_means": "原地转向控制系统利用车辆控制器根据接收到的原地转向指令控制左转向电机控制器和所述右转向电机控制器，左转向电机控制器根据接收到的原地转向指令控制左前轮转向，右转向电机控制器根据接收到的原地转向控制指令控制右前轮转向，且左前轮和右前轮的转动方向相反使得左前轮和右前轮之间形成预设角度的“内八字”，由转动电机控制向车辆控制器发送转向完成指令。",
  "tech_effect": "实现了车辆的原地掉头",
  "legal_status": [
    "失效",
    "有效",
    "审中",
    "PCT指定期满",
    "PCT指定期内",
    "未确认"
  ]
}

响应结构

API 响应数据的结构说明

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

成功响应示例

成功调用 API 的响应示例

JSON

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