药品说明书查询
drug-insertGEThttps://v1.apizero.cn/api/drug-insert概述
按药品名称搜索成药说明书,或用说明书 ID 拉取结构化全文(适应症、用法用量、不良反应、禁忌等)。 - 先用 `name` 搜索,从 `list[].id` 取说明书 ID - 再用 `id` 拉详情;`sections` 按原文小节返回 - 一次搜索最多约 50 条;未命中时 `found=false`,不是错误 - 仅供信息参考,不能替代执业医师 / 药师指导,也不能替代药盒说明书 【调用额度说明】 本接口额度以本页为准(与平台 VIP 在多数接口上的默认日免费额度不同): - 匿名试用:每日 2 次 - 登录免费:每日 5 次 - 黄金 VIP:每日 5,000 次 - 企业 VIP:按平台 VIP 日额度 - 高频场景:建议购买本接口基础版月卡 / 年卡(更高总量与 QPS);超出后也可按次计费
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/drug-insert/raw.md鉴权
匿名可调用:QPS=1、日 2 次(仅供试用);登录后:QPS=2、日 5 次;黄金会员:QPS=10、日 5000 次;钻石会员:QPS=30、日 10000 次;企业会员:QPS=120、日 1000000 次。批量查询请控制在每秒 120 次以内。额度与 QPS 与商品条码查询PRO 同档。
获取 API Key:获取 API Key/account/keys
请求头
必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。 |
按名称搜索
未命中时 found=false、list=[]。拿到 id 后再调详情。
https://v1.apizero.cn/api/drug-insert?name=%E9%98%BF%E8%8E%AB%E8%A5%BF%E6%9E%97
药品名称关键词,1–50 字
例阿莫西林
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| name(名称) | string | 是 | 药品名称关键词,1–50 字 | 阿莫西林 |
返回结果
search
回显的搜索词
是否至少命中一条
本次返回条数
匹配列表,最多约 50 条
说明书 ID,用于详情查询
药品名称
批准文号
适应症摘要
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| mode | string | search | ||||||||||||
| query | string | 回显的搜索词 | ||||||||||||
| found | boolean | 是否至少命中一条 | ||||||||||||
| total | integer | 本次返回条数 | ||||||||||||
| list | array | 匹配列表,最多约 50 条 | ||||||||||||
| ||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn | ||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"mode": "search",
"query": "阿莫西林",
"found": true,
"total": 3,
"list": [
{
"id": "sms125387",
"name": "阿莫西林胶囊",
"approval_no": "国药准字H14023222",
"indications": "阿莫西林适用于敏感菌(不产β内酰胺酶菌株)所致的下列感染:1.溶血链球菌、肺炎链球菌、葡萄球菌或流感嗜血杆菌所致中耳炎、鼻窦炎、咽炎、扁桃体炎等上呼吸道感染。"
},
{
"id": "sms125344",
"name": "阿莫西林胶囊",
"approval_no": "国药准字H13020473",
"indications": "阿莫西林适用于敏感菌(不产β内酰胺酶菌株)所致的下列感染。"
},
{
"id": "sms125093",
"name": "阿莫西林克拉维酸钾颗粒",
"approval_no": "国药准字H20163326",
"indications": "本品适用于产酶流感嗜血杆菌和卡他莫拉菌所致的下呼吸道感染,中耳炎、鼻窦炎。"
}
]
},
"tips": "极数本源 · https://apizero.cn"
}按 ID 取说明书
id 须来自搜索结果。内容仅供参考,请以药盒说明书为准。
https://v1.apizero.cn/api/drug-insert?id=sms125387
搜索结果返回的说明书 ID
例sms125387
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 搜索结果返回的说明书 ID | sms125387 |
返回结果
detail
说明书 ID
是否解析到小节
通用名 / 商品名(能解析到时)
说明书小节
小节标题,如 适应症 / 用法用量
小节纯文本(已去 HTML)
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | ||||||
|---|---|---|---|---|---|---|---|---|
| mode | string | detail | ||||||
| id | string | 说明书 ID | ||||||
| found | boolean | 是否解析到小节 | ||||||
| name | string | 通用名 / 商品名(能解析到时) | ||||||
| sections | array | 说明书小节 | ||||||
| ||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn | ||||||
{
"code": 0,
"msg": "成功",
"data": {
"mode": "detail",
"id": "sms125387",
"found": true,
"name": "阿莫西林胶囊",
"sections": [
{
"name": "通用名称",
"content": "阿莫西林胶囊"
},
{
"name": "商品名称",
"content": "阿莫西林胶囊"
},
{
"name": "汉语拼音",
"content": "A Mo Xi Lin Jiao Nang"
},
{
"name": "剂型",
"content": "胶囊剂"
},
{
"name": "性状",
"content": "本品为胶囊剂。"
},
{
"name": "主要成份",
"content": "阿莫西林。"
},
{
"name": "适应症",
"content": "阿莫西林适用于敏感菌(不产β内酰胺酶菌株)所致的感染,包括上呼吸道感染、泌尿生殖道感染等。"
}
]
},
"tips": "极数本源 · https://apizero.cn"
}请求示例
示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。
curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/drug-insert?name=%E9%98%BF%E8%8E%AB%E8%A5%BF%E6%9E%97&id=sms125387"错误码
先看业务 code。HTTP 也可能不是 200。
成功
参数错误
API Key 无效
API Key 已暂停
当前 IP 不在 Key 白名单
此接口需要 API Key
余额不足
调用过快(QPS)
今日免费额度已用完
接口已下线
接口不存在
服务器内部错误
上游暂时不可用
上游返回格式异常
暂无可用节点
| 业务码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 4000 | 400 | 参数错误 |
| 4011 | 401 | API Key 无效 |
| 4013 | 403 | API Key 已暂停 |
| 4014 | 403 | 当前 IP 不在 Key 白名单 |
| 4015 | 401 | 此接口需要 API Key |
| 4022 | 402 | 余额不足 |
| 4029 | 429 | 调用过快(QPS) |
| 4030 | 429 | 今日免费额度已用完 |
| 4040 | 503 | 接口已下线 |
| 4041 | 404 | 接口不存在 |
| 5000 | 500 | 服务器内部错误 |
| 5020 | 502 | 上游暂时不可用 |
| 5021 | 502 | 上游返回格式异常 |
| 5030 | 502 | 暂无可用节点 |
调用限制
- 计费模式
- 按次付费 · 点数包 · 月套餐
- QPS 限制
- 2 req/s
- 登录免费额度
- 5 次(已认证)
- 匿名每日额度
- 2 次(无 API Key)
- 黄金会员
- 每天 5,000 次 · 每秒 80 次
- 钻石会员
- 每天 10,000 次 · 每秒 30 次
- 企业会员
- 本接口约 79,800 次/月 · QPS 120
| 计费模式 | 按次付费 · 点数包 · 月套餐 |
|---|---|
| QPS 限制 | 2 req/s |
| 登录免费额度 | 5 次(已认证) |
| 匿名每日额度 | 2 次(无 API Key) |
| 黄金会员 | 每天 5,000 次 · 每秒 80 次 |
| 钻石会员 | 每天 10,000 次 · 每秒 30 次 |
| 企业会员 | 本接口约 79,800 次/月 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.0.02026-09-18
上架药品说明书查询:按名称搜索 + 按 ID 取结构化小节
免责声明
【用途声明】 本接口返回公开的药品说明书文本,仅供信息检索与展示。结果不能替代执业医师或药师的诊断、处方与用药指导,也不能替代药品包装内的正式说明书。
【准确性免责】
- 说明书内容可能滞后、节选或不完整,请以药盒说明书、生产企业最新版本及主管部门信息为准
- found=false / 列表为空仅表示当前未检索到匹配条目,不构成对药品合法性、真伪或可获得性的判断
- 用药前请咨询医护人员;处方药须凭处方使用
【责任豁免】 调用方因使用本接口数据产生的诊疗决策、用药后果、纠纷或损失,由调用方及最终用户自行承担。
【接受条款】 调用本接口即视为已阅读并同意上述条款。