https://www.shumaiapi.com/productDetail/199

 一、接口功能：药品信息查询接口能做什么？

药品信息查询接口的核心价值在于“查得准、查得快、查得全”。以数脉API的药品综合信息查询接口为例，该接口支持通过药品分类Id（classifyId）定位药品范围，再通过searchType和searchKey两个关键参数实现精准检索——searchType可设置为药品名称（1）、药企名称（2）、药准字号（3）或药品Id（4），searchKey则填入对应的查询关键字。这种多维度查询设计，兼顾了普通消费者的用药名查询需求和专业用户的药企信息检索需求。

在查询结果方面，接口返回的数据结构极为丰富。以“葡萄糖酸钙锌口服溶液”为例，返回字段涵盖了剂型（jx）、儿童用药说明（etyy）、贮藏条件（zc）、批准文号（pzwh）、药品名称（drugName）等基本信息，还包含药品多重分类信息——同一款药品可能同时归属于“妇科用药/更年期综合症”“维生素与矿物质/锌缺乏症”“儿科疾病”等多个分类维度，有效满足了不同业务场景的标签化需求。此外，注意事项字段详细列出了肾功能不全者慎用、过敏者禁用等关键安全提示，为合理用药提供了重要的参考依据。部分API服务商还支持输出30多个核心字段，涵盖适应症、禁忌症、不良反应、用法用量、药物相互作用等临床必需信息。

二、技术原理：药品信息查询接口是如何工作的？

从技术架构来看，药品信息查询API主要遵循RESTful风格，使用HTTP协议进行数据传输，数据格式采用轻量级的JSON。用户发起请求时，需携带appid（服务商分配的唯一标识）、timestamp（当前时间的毫秒数）和sign（签名）等公共参数，以验证调用方的合法身份。签名算法通常是MD5加密：将appid、timestamp和app_security通过“&”符号拼接成字符串，再对该字符串进行MD5哈希运算得到sign值，以此确保请求的防篡改与鉴权安全性。

在数据来源层面，药品信息查询接口背后依赖的是国家食品药品监督管理总局（NMPA）权威发布的药品标准数据库和监管信息平台。国家药品编码（包括本位码、监管码和分类码）为接口的标准化查询提供了基础支撑。本位码以“86”开头（代表中国境内生产销售的药品），前5位为企业标识，后5位为产品标识，形成了一品一码的精准映射。接口通过对接这些国家标准的编码体系，实现了药品信息的一致性识别与高效匹配，这也是接口能够支持药准字号精准查询的技术根基。

此外，国际上如HL7 FHIR的APIX标准，也正在推动全球范围内药品信息的互操作性互联，以实时数据替代传统静态文档，为药品信息查询接口的未来演进提供了技术参考。

三、应用场景：药品信息查询接口用在何处？

药品信息查询接口的应用场景极为广泛，贯穿了药品流通链条的各个环节。

药店与医药电商场景是最直接的应用领域。无论是连锁药店的ERP系统还是线上购药平台的商品数据库，都需要通过药品信息API实时同步药品的名称、规格、价格、库存及资质信息。例如，美团买药通过提供标准化药品信息API接口，实现了与漱玉平民大药房、海王星辰等头部连锁药店的系统对接，支持一次对接全国复用，有效降低了药店的信息化建设门槛。在浙江金华，“金药匙·云享药房”智能寻药平台依托药品信息查询和药店库存API，上线了“智能寻药”功能，全市2600余家药店实现联网，市民只需输入药品名称即可快速查询周边药店的库存情况并一键导航，真正实现了从“人等药”到“药等人”的服务升级。

处方审核与合理用药领域同样离不开药品信息接口的支持。丁香园等医疗数据开放平台基于药品说明书和权威医药知识库，利用药品API提供的成分、适应症、禁忌症、不良反应等数据，辅助药师进行处方点评，识别不合理处方，保障患者用药安全。AI临床助手则通过药品同步接口，将医院药品信息与国家标准编码体系对接，实现处方用药的合规性校验。

医保监管与药品追溯正在成为药品信息查询接口的新兴应用高地。国家医保局要求推动药品追溯码在医疗保障各环节的全量采集与全场景应用。在此背景下，药品信息API与追溯码系统深度融合，使每一盒药品的来源、去向、责任都可被数字化追踪。美团医药健康的追溯码数字化解决方案已与沈阳医保局系统全面对接，覆盖了海王星辰、漱玉平民等超百家线上医保药店。

四、如何对接药品信息查询接口？

对接药品信息查询接口的操作流程通常包括以下几个关键步骤：

第一步：注册与认证。 开发者需要在API服务商平台注册账号并完成实名认证（个人或企业），申请获取appid和app_security密钥，这些凭证将用于后续所有API调用的身份鉴权。

第二步：理解签名与请求机制。 每次API请求都必须包含正确的签名。以数脉API为例，签名算法是将appid、timestamp和app_security三者拼接后经MD5加密生成sign值。示例代码显示，若appid为“xyzxyzxyz”、timestamp为“1555378976238”、app_security为“efcefcefcefcefc”，拼接得到的字符串为“xyzxyzxyz&1555378976238&efcefcefcefcefc”，经MD5加密后得到sign值“4e7e1974b79f3656aeaf03f1158f5d5d”。部分政府追溯接口采用更为安全的SHA256算法，拼接ak、timestamp、sk和param后计算哈希值完成验签。

第三步：构造请求并发起调用。 根据接口文档构造HTTP请求（通常为POST或GET方式），将appid、timestamp、sign、classifyId、searchType、searchKey、page、maxResult等参数以JSON或表单格式发送至接口地址。请求地址示例为：https://api.shumaidata.com/v10/medical_v2/detail。

第四步：解析返回结果。 接口返回结果为JSON格式，包含msg（提示信息）、code（状态码）、data（数据体）等字段，其中drugList数组封装了药品的详细信息。开发者需要对这些数据进行解析和业务逻辑处理。此外，API Explorer类工具可提供在线调试、签名验证和SDK代码自动生成功能，极大降低了开发者的对接门槛。