[P067]专利/论文Markdown获取工具
为AI Agent设计的专利和论文数据读取工具。根据传入的key列表（url或专利公开号pn），批量获取对应的Markdown格式数据，便于AI进行内容分析、推理和问答。支持模块化查询（basic/citation/legal/family）、图片处理和内容压缩。
支持批量获取专利或论文的Markdown格式数据。每次请求最多100个key，建议10-20个。输入的key支持url（包含patentId或paperId的url）和专利公开号pn两种格式。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | array | [
"https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=07c38692-9ccf-4ead-8f0f-484f7aa929b7"
] | key列表（输入的key（url（包含patentId或paperId的url）、专利公开号pn）），数量限制1-100个，建议10-20个 |
| string | url | key类型。url：包含patentId或paperId的url；pn：专利公开号 |
| boolean | - | 是否压缩返回的Markdown内容（使用gzip+base64编码），当返回内容较大时建议开启 |
| boolean | - | 是否包含图片链接（仅对专利有效，会自动对图片URL进行签名处理） |
| array | [
"basic",
"citation",
"legal",
"family"
] | 查询模块列表。专利可选：basic、citation、legal、family；论文可选：basic。默认查询basic模块 |
| boolean | - | 是否返回结构化原始JSON数据（structured字段），默认不返回。当需要获取原始结构化数据进行二次处理时开启 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
total | integer<int32> | 2 | 提交的总数量 |
results | array | [
{
"key": "https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=07c38692-9ccf-4ead-8f0f-484f7aa929b7",
"images": [
{
"image_id": "HDA0003320126060000011",
"image_url": "https://example.com/image.png"
}
],
"source": "patent",
"message": "获取成功",
"modules": [
"basic",
"citation",
"legal",
"family"
],
"success": true,
"compress": false,
"key_type": "url",
"markdown": "# 专利详细信息\n\n## 基本信息\n...",
"structured": {}
}
] | 获取结果列表，包含每个key的详细结果 |
key | string | https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=07c38692-9ccf-4ead-8f0f-484f7aa929b7 | 原始输入的key（url或专利公开号pn） |
images | array | [
{
"image_id": "HDA0003320126060000011",
"image_url": "https://example.com/image.png"
}
] | 图片信息列表（仅专利且include_images=true时有值） |
image_id | string | HDA0003320126060000011 | 图片ID |
image_url | string | https://example.com/image.png | 图片URL（已签名） |
source | string | patent | 数据来源类型：patent（专利）或paper（论文） |
message | string | 获取成功 | 处理消息（成功或失败原因） |
modules | array | [
"basic",
"citation",
"legal",
"family"
] | 查询模块列表 |
success | boolean | true | 是否获取成功 |
compress | boolean | - | markdown内容是否已压缩（gzip+base64） |
key_type | string | url | key类型（url或pn） |
markdown | string | # 专利详细信息
## 基本信息
... | 转换后的Markdown内容 |
structured | object | {
"basic": {
"title": "专利标题",
"abstract": "专利摘要...",
"patent_id": "07c38692-9ccf-4ead-8f0f-484f7aa929b7"
}
} | 结构化原始JSON数据，按模块分组（basic/citation/legal/family），未请求的模块为null；仅include_structured=true时有值 |
time_cost | number<double> | 12.5 | 总耗时（秒） |
failed_count | integer<int32> | - | 失败的数量 |
success_count | integer<int32> | 2 | 成功获取的数量 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"total": 2,
"status": true,
"results": [
{
"key": "https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=07c38692-9ccf-4ead-8f0f-484f7aa929b7",
"images": [
{
"image_id": "HDA0003320126060000011",
"image_url": "https://example.com/image.png"
}
],
"source": "patent",
"message": "获取成功",
"modules": [
"basic",
"citation",
"legal",
"family"
],
"success": true,
"compress": false,
"key_type": "url",
"markdown": "# 专利详细信息\n\n## 基本信息\n...",
"structured": {
"basic": {
"title": "专利标题",
"abstract": "专利摘要...",
"patent_id": "07c38692-9ccf-4ead-8f0f-484f7aa929b7"
}
}
}
],
"time_cost": 12.5,
"error_code": 0,
"failed_count": 0,
"success_count": 2
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
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 | 请求成功 |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
422 | Validation Error |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms