在哪里可以找到 [AI35-12]查新检索-添加对比文献或专利的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1ai~1novelty-search~1feature~1comparison~1generate/post，也可在 /openapi.json 浏览完整规范。

[AI35-12]查新检索-添加对比文献或专利

Q: [AI35-12]查新检索-添加对比文献或专利 的接口地址是什么？

[AI35-12]查新检索-添加对比文献或专利 的接口为 POST https://connect.zhihuiya.com/ai/novelty-search/feature/comparison/generate。

Q: [AI35-12]查新检索-添加对比文献或专利 可以返回哪些数据？

[AI35-12]查新检索-添加对比文献或专利：基于用户需要手动添加对比文献或专利的情况，可使用该接口的出参，作为“[AI35-9]查新检索-确认筛选列表与特征对比”的“final_result”中、某部分入参内容。。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://connect.zhihuiya.com/ai/novelty-search/feature/comparison/generate

在体验中心中试用

基于用户需要手动添加对比文献或专利的情况，可使用该接口的出参，作为“[AI35-9]查新检索-确认筛选列表与特征对比”的“final_result”中、某部分入参内容。

注意：辅助性功能，非必须步骤。需要提供有效的技术特征和请求参数。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`request` 必填	`object`	`{ "pn": "CN118289111A", "is_add_patent": true, "add_patent_selected": true }`	特征对比参数
`add_patent_selected`	`boolean`	`true`	新增专利是否默认选中进入文献确认
`is_add_patent`	`boolean`	`true`	是否新增专利
`pn` 必填	`string`	`CN118289111A`	专利PN号
`tech_features` 必填	`array`	[ { "selected": true, "user_add": false, "feature_num": "F1", "feature_weight": "topic", "feature_elements": "电话机, 图像识别能力", "feature_function": "提供一种能够实现图像信息采集、文字识别及信息获取功能的电话机整体结构", "feature_text_original": "具有图像识别能力的电话机", "feature_weight_reason": "本技术方案的主题名称，明确保护对象为具有图像识别能力的电话机" }, { "selected": true, "user_add": false, "feature_num": "F1.1", "feature_weight": "core", "feature_elements": "电话, 摄像装置, 链接关系", "feature_function": "通过在电话机中集成摄像装置，实现电话机对外部图像信息的采集", "feature_text_original": "包括电话、与电话链接的摄像装置", "feature_weight_reason": "现有电话机通常不具备与摄像装置链接的结构，属于本方案为实现图像采集功能而新增的结构" }, { "selected": true, "user_add": false, "feature_num": "F1.2", "feature_weight": "core", "feature_elements": "命令, 摄像装置, 控制", "feature_function": "通过命令控制摄像装置的工作，实现电话机对图像采集过程的自动化管理", "feature_text_original": "至少包括一个用于控制与电话链接的摄像装置工作的命令", "feature_weight_reason": "现有电话机未涉及通过命令控制外部摄像装置工作的功能，属于本方案为实现自动化图像采集新增的控制手段" }, { "selected": true, "user_add": false, "feature_num": "F1.3", "feature_weight": "core", "feature_elements": "图像信息, 文字信息, 获取", "feature_function": "利用图像识别技术对采集到的图像进行处理，自动提取图像中的文字信息，实现图像到文字的转换", "feature_text_original": "根据摄取的图像信息获取该图像信息源的文字信息", "feature_weight_reason": "现有电话机无法自动识别图像中的文字信息，属于本方案为实现文字信息自动提取而新增的功能" }, { "selected": true, "user_add": false, "feature_num": "F1.4", "feature_weight": "core", "feature_elements": "文字信息, 电话显示器, 显示", "feature_function": "将识别出的文字信息通过电话显示器展示，实现用户对图像文字内容的直接获取", "feature_text_original": "并将文字信息显示在电话显示器上", "feature_weight_reason": "现有电话机不具备将图像识别出的文字信息显示的功能，属于本方案为提升用户体验新增的显示手段" }, { "selected": true, "user_add": false, "feature_num": "F1.5", "feature_weight": "core", "feature_elements": "电路算法, 地址, 网络数据库, 文字信息", "feature_function": "通过电路算法解析获取图像相关信息的地址，并从网络数据库中进一步获取相关文字信息，实现电话机信息获取能力的扩展", "feature_text_original": "电话机通过电路算法首先得到地址，再通过该地址从相关显示器的网络数据库得到文字信息", "feature_weight_reason": "现有电话机不具备通过电路算法获取地址并从网络数据库获取相关文字信息的功能，属于本方案为实现信息扩展获取而新增的技术手段" } ]	技术特征列表
`feature_elements`	`string`	`电话机, 图像识别能力`	特征要素
`feature_function`	`string`	`提供一种能够实现图像信息采集、文字识别及信息获取功能的电话机整体结构`	特征功能
`feature_num`	`string`	`F1`	特征编号
`feature_text`	`string`	`具有图像识别能力的电话机`	特征文本
`feature_text_original`	`string`	`具有图像识别能力的电话机`	原始特征文本
`feature_weight`	`string`	`topic`	特征权重
`feature_weight_reason`	`string`	`本技术方案的主题名称，明确保护对象为具有图像识别能力的电话机`	特征权重理由
`selected`	`boolean`	`true`	是否选中
`user_add`	`boolean`	-	是否用户添加

请求示例

该 API 接口的请求体示例

JSON

{
  "request": {
    "pn": "CN118289111A",
    "is_add_patent": true,
    "add_patent_selected": true
  },
  "tech_features": [
    {
      "selected": true,
      "user_add": false,
      "feature_num": "F1",
      "feature_text": "具有图像识别能力的电话机",
      "feature_weight": "topic",
      "feature_elements": "电话机, 图像识别能力",
      "feature_function": "提供一种能够实现图像信息采集、文字识别及信息获取功能的电话机整体结构",
      "feature_text_original": "具有图像识别能力的电话机",
      "feature_weight_reason": "本技术方案的主题名称，明确保护对象为具有图像识别能力的电话机"
    }
  ]
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`final_res`	`array`	`[ { "lang": "zh", "claims": [ { "claim_num": 1, "claim_text": "一种数据处理方法，其特征在于..." } ], "document": "一种基于人工智能的数据处理方法", "features": [ { "score": 85, "public_score": 90, "tech_feature": "人工智能算法", "comparison_feature": "机器学习算法" } ], "patent_id": "CN123456789A", "public_score": 87.5 } ]`	最终结果
`lang`	`string`	`zh`	语言
`claims`	`array`	`[ { "claim_num": 1, "claim_text": "一种数据处理方法，其特征在于..." } ]`	权利要求原始文本清单
`claim_num`	`integer<int32>`	`1`	权利要求编号(权1，权2，权3)
`claim_text`	`string`	`一种数据处理方法，其特征在于：包括数据采集步骤、数据预处理步骤和数据分析步骤。`	权利要求原始文本
`document`	`string`	`一种基于人工智能的数据处理方法`	文档
`features`	`array`	`[ { "score": 85, "public_score": 90, "tech_feature": "人工智能算法", "comparison_feature": "机器学习算法" } ]`	特征词清单
`type`	`string`	`public`	CC标签类型
`score`	`integer<int32>`	`85`	打分
`differ`	`string`	`NONE`	差异标识
`public_score`	`integer<int32>`	`90`	公开度打分
`tech_feature`	`string`	`人工智能算法`	特征词
`comparison_feature`	`string`	`机器学习算法`	对比特征词
`patent_id`	`string`	`CN123456789A`	专利ID
`public_score`	`number<float>`	`87.5`	公开度打分
`threshold`	`integer<int32>`	`75`	阈值
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "final_res": [
      {
        "lang": "zh",
        "claims": [
          {
            "claim_num": 1,
            "claim_text": "一种数据处理方法，其特征在于：包括数据采集步骤、数据预处理步骤和数据分析步骤。"
          }
        ],
        "document": "一种基于人工智能的数据处理方法",
        "features": [
          {
            "type": "public",
            "score": 85,
            "differ": "NONE",
            "public_score": 90,
            "tech_feature": "人工智能算法",
            "comparison_feature": "机器学习算法"
          }
        ],
        "patent_id": "CN123456789A",
        "public_score": 87.5
      }
    ],
    "threshold": 75
  },
  "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