专利申请全量数据接口文档

1. 接口概述

• 接口名称：获取全部专利申请数据
  地址：GET /patent-applications/{tenantId}
• Content-Type：application/json
• 分页：不分页，一次请求返回当前租户的全部专利申请

该接口按 PUMCH 专利申请表单返回当前租户全部专利申请。每条记录包含专利页面
保存的完整 formData，以及从表单任意层级递归汇总出的全部附件。openapi 会为每个
附件补充完整 downloadUrl，供第三方直接下载。

2. 调用链路

1. 第三方系统调用：GET /patent-applications/{tenantId}。
2. openapi 使用 App-Key、Timestamp、Sign 完成系统凭据鉴权。
3. tenantId 为企业租户id,需要联系东篱获取

   3. 鉴权说明

3.1 请求头

3.2 签名算法

Sign = MD5(App-Key + Secret + Timestamp)

• 三段字符串直接拼接，不添加分隔符。
• Secret 是 openapi 为该 App-Key 配置的系统凭据密码。
• Java 示例：DigestUtils.md5Hex(appKey + secret + timestamp)。

4. 请求说明

该接口没有路径参数、查询参数和请求体。租户由 openapi 根据 App-Key 自动确定。

GET /api/patent-applications HTTP/1.1
Host: openapi.example.com
App-Key: patent-client
Timestamp: 1783909200
Sign: 9f2d8d6c2b2f7e4f2b17d8739ec18d4a

5. 响应结构

5.1 集合字段

5.2 单条专利字段

6. PUMCH 表单字段

以下字段来自 PUMCH 的 patent-application 和 patent-application.details 表单。
字段未填写、被条件隐藏或属于历史版本时，可能不出现在某条记录中。

6.1 主表单字段

历史表单还可能包含 year、categoryNum、applicationNum、remarks、
patentAgencyInfo、attachments 等字段，接口同样原样返回。

6.2 专利权人字段

6.3 发明人字段

6.4 附件字段

downloadUrl 规则：完整 http:// / https:// 地址保持不变；/resource/...
等相对地址使用科研平台 application.keyan.url 的协议和主机补全。

6.5 流程记录字段

7. 响应示例

{
  "total": 2,
  "contents": [
    {
      "id": "01J2PATENT000001",
      "tenantId": "highsoft",
      "state": "finished",
      "patentState": "申请",
      "taskId": null,
      "processSchedule": "已完成",
      "creatorId": "person-001",
      "createdAt": "2026-07-13T01:02:03Z",
      "lastUpdaterId": "person-001",
      "lastUpdatedAt": "2026-07-13T02:03:04Z",
      "formData": {
        "applicationDate": "2026-07-13",
        "country": "中国",
        "type": "发明专利",
        "title": "一种医疗装置",
        "whetherFunded": true,
        "projectIds": ["project-001"],
        "patenteeItems": [
          {
            "patenteeType": false,
            "patenteeTypeName": "本单位",
            "name": "北京协和医院",
            "ranking": "第一",
            "rankingName": "第一"
          }
        ],
        "inventors": [
          {
            "personId": "person-001",
            "name": "张三",
            "code": "10001",
            "departmentName": "心内科",
            "ranking": "第一",
            "rankingName": "第一"
          }
        ],
        "applicationFormAttachments": [
          {
            "name": "专利申请单.pdf",
            "url": "/resource/assets/application.pdf"
          }
        ],
        "disclosureAttachments": [
          {
            "name": "专利交底书.docx",
            "url": "https://files.example.com/disclosure.docx"
          }
        ],
        "processRecord": [
          {
            "id": "task-001",
            "taskName": "科室主任审核",
            "assignee": "person-002",
            "assigneeName": "李四",
            "operationTime": "2026-07-13T02:00:00Z",
            "result": "通过",
            "approvalComments": "同意"
          }
        ]
      },
      "attachments": [
        {
          "path": "applicationFormAttachments[0]",
          "name": "专利申请单.pdf",
          "url": "/resource/assets/application.pdf",
          "downloadUrl": "https://research.example.com/resource/assets/application.pdf"
        },
        {
          "path": "disclosureAttachments[0]",
          "name": "专利交底书.docx",
          "url": "https://files.example.com/disclosure.docx",
          "downloadUrl": "https://files.example.com/disclosure.docx"
        }
      ]
    },
    {
      "id": "01J2PATENT000002",
      "tenantId": "highsoft",
      "formData": {
        "title": "一种检测方法"
      },
      "attachments": []
    }
  ]
}

8. 错误说明

9. curl 示例

curl -X GET "https://<openapi-host>/api/patent-applications" \
  -H "App-Key: patent-client" \
  -H "Timestamp: 1783909200" \
  -H "Sign: 9f2d8d6c2b2f7e4f2b17d8739ec18d4a"

调用前请使用实际 App-Key、Secret 和当前 Timestamp 重新计算 Sign。

10. 数据量说明

该接口按需求不分页，一次返回当前租户全部专利数据。调用方应适当提高 HTTP
读取超时时间，并避免高频轮询。若后续数据量增长明显，建议另增按更新时间增量同步接口，
但本接口仍保留全量获取语义。