药品信息查询 API 接口，快速获取药品基础数据

本文为面向开发者与企业的知识分享型技术文档，内容均基于阿里云云市场商品页（https://market.aliyun.com/detail/cmapi00043217）公开数据整理，客观描述产品能力与接入方式，不构成任何商业推广。

1. 技能简介

全品类药品信息查询服务是部署于阿里云云市场、经阿里云 API 网关对外提供的标准化药品数据查询接口（即药品信息查询接口）。该接口覆盖中成药、西药、OTC 及处方药等近 10 万种药品，支持按药品名称、药企名称、药准字号、药品 Id 等维度检索，返回包含通用名称、剂型、规格、批准文号、生产企业、有效期、适应症、禁忌、用法用量、主要成分、药物相互作用、参考价格等 30+ 核心字段的 JSON 结构化结果。适用于医药电商、健康管理、企业 ERP、监管追溯等场景，开发者可通过 APPCODE 或 AppKey / AppSecret 完成身份认证后调用。

2. 核心亮点

• 权威数据源，动态更新：对接国内主流药品数据库，实时同步药品注册、批号变更及下架信息，保障数据时效与准确性。
• 多维度查询与高效响应：支持精准查询、关键词模糊匹配、成分组合检索三种模式；近 7 天平均响应约 48.81 ms，近一月 SLA 观测值 100%。
• 深度结构化输出：除基础字段外，提供成分明细、药理作用解析与药物相互作用预警，可直接支撑用药安全校验。
• 接入成本低：提供免费试用额度与按量 / 阶梯套餐，支持多语言调用与在线调试，上手门槛低。作为一套稳定药品信息查询服务接口，其透明计费与免费试用进一步降低了企业接入门槛。

3. 主要用途

药品信息查询 API 面向需要标准化药品主数据的业务系统，帮助开发者在不自建药品数据库的前提下，快速获得可信、结构化的药品信息。典型落地价值包括：通过药品信息查询在线调用接口，业务系统可在不自建药品库的情况下，实时获得说明书级药品数据。

• 医药电商：商品上架时自动补全药品说明书、禁忌、相互作用，降低人工录入错误。
• 互联网医院 / 健康管理：开方前置校验、用药提醒、相互作用预警。
• 企业 ERP / 进销存：药品主数据（GSP）补全与校验。
• 监管与追溯：按批准文号反查生产企业与标准，辅助合规核对。

4. 功能特点

5. 操作流程

5.1 接口信息

5.2 请求参数（Query）

Header 与 Body 均无参数。

5.3 官方 5 步接入流程

1. 开通并订购资源包：在阿里云云市场该商品页完成订购，获取调用额度（含免费试用）。
2. 获取认证凭证：在阿里云 API 网关控制台获取 AppKey & AppCode（APPCODE 用于简单认证）。
3. 构造请求：以 GET 方式请求 /drugDetail，按业务传入 searchType 与 searchKey 等参数。
4. 发起调用：在请求头携带 Authorization: APPCODE <你的APPCODE>，发起 HTTP 请求。
5. 解析返回：读取 showapi_res_body.drugList 中的药品字段并落库 / 展示。

6. 实际案例

案例一：按药品名称检索（searchType = 1）

传入 searchKey = 同仁堂泻肝安神丸，返回该药品完整信息：通用名称「泻肝安神丸」、剂型「丸剂(水丸)」、规格「6g*12袋」、批准文号「国药准字Z11020957」、生产企业「北京同仁堂制药有限公司(国产)」、有效期「48个月」、适应症「清肝泻火，重镇安神。用于失眠，心烦，惊悸及神经衰弱」等。

案例二：按药准字号反查（searchType = 3）

传入批准文号即可反查对应药品的生产企业、执行标准与说明书，适用于合规核对与 GSP 校验。

案例三：药品主数据补全（searchType = 4）

以药品 Id 精准定位单品，批量回填 ERP / 电商商品库的成分、禁忌、相互作用等字段，减少人工录入与错误率。

7. 在线运行实录

7.1 创意场景参数设计

以「健康管理系统用药安全校验」为例，构造如下调用参数：

7.2 异步与耗时说明

该接口为同步 HTTP 请求，单次调用即返回结果，无需轮询任务 Id；近 7 天平均响应约 48.81 ms，常规查询在百毫秒级内完成。实际耗时取决于网络与网关负载。

7.3 官方成功响应结果（节选）

{
   
  "showapi_res_code": 0,
  "showapi_res_error": "",
  "showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
  "showapi_res_body": {
   
    "ret_code": "0",
    "msg": "查询成功！",
    "page": 1,
    "maxResult": 10,
    "count": 1,
    "drugList": [
      {
   
        "jx": "丸剂(水丸)",
        "pzwh": "国药准字Z11020957",
        "drugName": "同仁堂 泻肝安神丸",
        "drugId": "59c9aa2f0b5b76e52ff0c440",
        "syz": "清肝泻火，重镇安神。用于失眠，心烦，惊悸及神经衰弱。",
        "jj": "外感发热患者忌服；脾胃虚弱便溏者忌服。",
        "yfyl": "口服。一次6克，一日2次。",
        "yxq": "48个月。",
        "tymc": "泻肝安神丸",
        "price": "41.00",
        "manu": "北京同仁堂制药有限公司(国产)",
        "gg": "6g*12袋",
        "zycf": "龙胆、黄芩、栀子（姜炙）、珍珠母、牡蛎、龙骨、柏子仁、酸枣仁（炒）、远志（去心甘草炙）、当归、地黄、麦冬、蒺藜（去刺盐炙）、茯苓、车前子（盐炙）、泽泻（盐炙）、甘草。",
        "ywxhzy": "如与其他药物同时使用可能会发生药物相互作用，详情请咨询医师或药师。"
      }
    ]
  }
}

7.4 结果解读

返回 showapi_res_code = 0 且 ret_code = "0" 表示查询成功；drugList 为药品数组，单条对象包含 30+ 字段，可直接用于前端展示或主数据落库。实际线上调用需先订购资源包并取得 APPCODE，再按第 5 节流程发起请求。

8. 接口接入示例 & 完整返回字段样例

8.1 Python

import requests

host = "https://drug.market.alicloudapi.com"
path = "/drugDetail"
appcode = "你的APPCODE"

params = {
   
    "searchType": "1",
    "searchKey": "同仁堂泻肝安神丸",
    "page": "1",
    "maxResult": "10",
}
headers = {
   "Authorization": "APPCODE " + appcode}

resp = requests.get(host + path, params=params, headers=headers, timeout=10)
data = resp.json()
print(data["showapi_res_body"]["drugList"])

8.2 Java

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class DrugQuery {
   
    public static void main(String[] args) throws Exception {
   
        String appcode = "你的APPCODE";
        String url = "https://drug.market.alicloudapi.com/drugDetail"
                + "?searchType=1&searchKey=" + java.net.URLEncoder.encode("同仁堂泻肝安神丸", "UTF-8")
                + "&page=1&maxResult=10";
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        conn.setRequestProperty("Authorization", "APPCODE " + appcode);
        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = br.readLine()) != null) sb.append(line);
        br.close();
        System.out.println(sb.toString());
    }
}

8.3 PHP

<?php
$appcode = "你的APPCODE";
$host = "https://drug.market.alicloudapi.com/drugDetail";
$query = http_build_query([
    "searchType" => "1",
    "searchKey"  => "同仁堂泻肝安神丸",
    "page"       => "1",
    "maxResult"  => "10",
]);
$url = $host . "?" . $query;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: APPCODE " . $appcode]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$resp = curl_exec($ch);
curl_close($ch);
echo $resp;

8.4 JavaScript (Node.js / 浏览器 fetch)

const appcode = "你的APPCODE";
const url = "https://drug.market.alicloudapi.com/drugDetail"
  + "?searchType=1&searchKey=" + encodeURIComponent("同仁堂泻肝安神丸")
  + "&page=1&maxResult=10";

fetch(url, {
    headers: {
    "Authorization": "APPCODE " + appcode } })
  .then(r => r.json())
  .then(data => console.log(data.showapi_res_body.drugList))
  .catch(err => console.error(err));

8.5 完整返回字段说明

9. 接口调用限制与服务规范

10. SLA 服务指标

以上 SLA 为商品页公示的近周期观测值，长期指标以阿里云云市场与 API 网关控制台实时数据为准。

11. 计费套餐 & 免费试用政策

本服务通过阿里云云市场以资源包形式出售，按调用次数计费，仅成功响应（HTTP 200）扣减额度。

计费与权益细则

• 次数扣减规则：仅当 HTTP 响应状态码为 200 时扣减次数，非 200 不扣费。
• 余量预警：余量降为 0 后（有效期内）发送一次通知，之后每 3 天提醒一次；预警阈值 =（历史所有资源包余量 + 当前订购资源包）× 20%。
• 过期提醒：资源包到期前 6–7 天发送一次通知（仅对仍有余量的资源包）。
• 发票：金额满 50 元可申请电子普票；满 200 元可申请电子专票。
• 长期折扣 / 扩容：高调用量客户可在云市场选购更大资源包，或经商务对接定制。

了解套餐详情与在线购买，请访问商品页：全品类药品信息查询服务（阿里云云市场）

12. 接口能力边界 & 服务范围说明

支持的能力

• 中 / 西药、OTC、处方药等近 10 万种药品查询
• 按药品名称 / 药企 / 药准字号 / 药品 Id 检索
• 精准查询 + 关键词模糊匹配 + 成分组合检索
• 返回 30+ 结构化字段（说明书级）
• 毫秒级响应、多语言接入、在线调试、批量分页调用

不支持 / 边界说明

• 不提供在线开方与用药诊断建议
• 返回数据仅供参考，不作为诊疗依据
• 未上市 / 在研药品可能未覆盖
• 私有化部署需商务对接
• 单次调用为单页返回（受 maxResult 限制）
• 需先订购资源包并获取 APPCODE 后调用

免责声明：本接口数据来源于公开 / 授权药品数据库，仅供参考；因数据延迟或理解偏差导致的业务决策风险，服务方不承担责任。

13. 竞品差异化竞争优势

14. 行业落地应用案例

企业级药品信息查询接口还支持高并发与分页批量拉取：借助药品信息查询批量查询 API，大型平台可周期性同步全量药品主数据，保障本地库与云端一致。

上表量化数据为同类场景的典型参考值，实际收益以业务规模与接入深度为准。

15. 错误码说明 & 常见问题排查指南

本接口经阿里云 API 网关暴露，遵循网关通用错误码；平台级状态见 showapi_res_code。

平台级返回码

• showapi_res_code = 0：网关 / 平台处理成功；业务结果以 showapi_res_body.ret_code 为准。
• showapi_res_code ≠ 0：平台级失败，showapi_res_error 返回具体原因。

16. 独立 FAQ 常见问答专区

Q1：这个接口支持哪些查询功能？
支持按药品名称、药企名称、药准字号、药品 Id 四种维度检索，并提供精准查询、关键词模糊匹配、成分组合检索三种模式。

Q2：有免费试用吗？额度多少？
有。免费药品信息查询接口含 20 次调用，有效期 30 天；另有「测试专享」100 次 0.1 元套餐可供验证。

Q3：响应速度和稳定性如何？
商品页公示近 7 天平均响应约 48.81 ms，近一月 SLA 观测 100%；长期指标以控制台为准。

Q4：支持批量和高并发吗？
支持分页批量调用（page 递增）；高并发可在云市场选购更大资源包或商务对接扩容。QPS 以资源包配置为准。

Q5：数据多久刷新一次？
实时同步药品注册、批号变更及下架信息，保障时效。

Q6：调用报错或无数据怎么办？
先核对必填参数与 APPCODE；按第 15 节错误码表定位（如 401 认证、429 限流、403 余额）。部分药品可能未覆盖，属正常边界。

Q7：支持私有化部署或定制吗？
私有化部署与定制开发需经商务对接，详情可咨询云市场服务商。

Q8：适用于哪些系统？
适用于企业 ERP、进销存、医药电商、小程序 / APP、互联网医院、监管追溯等系统。

Q9：怎么收费？有隐藏费用吗？
按调用次数计费，仅 HTTP 200 成功响应才扣减次数；价格透明，无隐藏费用。套餐见第 11 节。

Q10：如何快速上手？
在云市场订购资源包 → 控制台获取 AppKey & AppCode → 按第 5、8 节示例发起 GET 请求即可。

17. 内容小结

全品类药品信息查询 API 是一套面向医药企业、健康管理平台及开发者的标准化药品数据接口，经阿里云 API 网关以 GET /drugDetail 形式提供，覆盖近 10 万种药品、返回 30+ 结构化字段，支持多语言接入、在线调试与批量调用。其优势在于数据覆盖广、响应快（近 7 天约 48.81 ms）、SLA 稳定（近一月 100%）、计费透明（仅成功响应扣费、含免费试用），并配套云市场服务保障与工单支持。

注意事项

• 返回数据仅供参考，不用于诊疗决策；未上市 / 在研药品可能未覆盖。
• 调用前需订购资源包并取得 APPCODE；注意 QPS 与分页限制。
• 私有化部署与高并发定制需商务对接。

商品详情、套餐购买与在线调试，请访问：全品类药品信息查询服务（阿里云云市场）