[AI66-9]防侵权检索-按公开号权利要求对比
仅输入已有 task_id 与 patent_pns。使用该任务保存的技术方案,解析公开号后复用 CC 分析;未找到的号码在结果的 unresolved_pns 中返回。全部未找到时状态为 failed。单次最多 200 篇。POST 立即返回 running,结果通过 GET /fto_steps/result?step_name=feature_comparison&task_id={task_id} 查询。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | string | fto-20260917-a1b2c3d4 | 已有 FTO 任务 ID,必传且不可为空串(此处不做自动生成兜底);该任务须已有落库的技术方案,否则返回 422。 |
必填 | array | [
"CN103192928B"
] | 待比对的专利公开号列表,例如 CN103192928B;单次最多 200 篇,1-200 篇区间外或含空白项均返回 422。全部解析不到(专利库中找不到任何一个号)时返回 422,不会静默当作零结果。 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
status必填 | string | running | 提交后的状态,固定为 running;实际执行在后台进行,用 GET 轮询终态。 |
task_id必填 | string | fto-20260928-a1b2c3d4 | 任务 ID;请求体未传时为本次调用自动生成的值,后续步骤须带着它才能接力。 |
step_name必填 | string | proposal_refine | 提交的步骤名,与 URL 路径一致。 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"status": true,
"task_id": "fto-20260928-a1b2c3d4",
"step_name": "proposal_refine",
"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 | 请求成功 |
422 | Validation Error |
409 | 同一 task_id 已有步骤正在运行 |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms