技术博客
药品参考价格(price)字段解读与使用注意

药品参考价格(price)字段解读与使用注意

作者: 万维易源
2026-09-03
药品参考价格price字段说明
# 药品参考价格(price)字段解读与使用注意 - **接口/接入点**:药品信息查询(apiCode=1468)· 1468-3 / 1468-4 返回 - **是否免费**:免费(有档位限制) - **请求方式**:POST / GET - **返回格式**:JSON - **适用人群**:中高级开发者、产品经理 - **阅读时间**:约 3 分钟 ## 核心要点 - `price` 字段在 1468-3 / 1468-4 的**返回示例**中出现(如 `"41.00"`),但官方字段表**未正式列示**。 - 它不是字段表承诺的标准字段,是否返回、取值是否准确取决于数据源——**以实际返回为准,不要当作官方定价**。 - 对外展示价格时务必标注「参考价」,并避免据此做交易决策。 ## Why:为什么单独讲 price 文档字段表没写、返回里却有,这种「影子字段」最容易让人误用:要么以为每次都有,要么直接当成官方售价。本文把它讲清,避免合规与体验风险。 ## What:字段事实 | 项 | 说明 | |------|------| | 来源 | 1468-3 / 1468-4 真实返回示例中出现 `price`(String,如 "41.00") | | 字段表 | 官方字段表未列出 `price` | | 性质 | 参考价,非官方统一定价,是否返回不确定 | ## How:安全使用 ```python import requests APPKEY = "YOUR_APPKEY" r = requests.post("https://route.showapi.com/1468-4", data={"appKey": APPKEY, "searchKey": "阿司匹林", "page": "1"}, timeout=10) for d in r.json()["showapi_res_body"]["drugList"]: price = d.get("price") # 可能缺失,务必用 .get 兜底 if price: print(f"{d['drugName']} 参考价:{price}(仅供参考,非官方定价)") else: print(f"{d['drugName']} 暂无价格信息") ``` ## 返回示例与解析 ```json { "drugName": "同仁堂 泻肝安神丸", "price": "41.00", "manu": "北京同仁堂制药有限公司(国产)" } ``` `price` 为字符串类型;缺失时不报错,用 `dict.get` 兜底即可。 ## 进阶 / 边界 - **不要缓存为依据**:price 非字段表承诺字段,可能随药品变化或缺失,不可作为稳定业务字段依赖。 - **合规提示**:药品实际售价以药房/平台实时标价为准;展示参考价时注明来源与「仅供参考」,避免误导消费者。 ## FAQ **Q1:price 每次都返回吗?** A:文档字段表未列示,返回示例中出现过,但是否每次返回不确定,代码务必用 `.get("price")` 兜底。 **Q2:price 能当官方售价用吗?** A:不能。它是参考价,非官方统一定价,对外展示需标注「仅供参考」。 **Q3:为什么字段表没有 price 我却收到了?** A:属于返回示例中存在但字段表未覆盖的字段;以实际返回为准,使用时做好缺失处理。 ## 相关能力 / 下一步阅读 - [药品信息查询返回字段全解](https://www.showapi.com/guides/drug-info-fields-1468) - [药名查询药品信息(1468-4)实战指南](https://www.showapi.com/guides/drug-info-search-name-1468) - [药品详细信息检索:searchType 四种类型与 classifyId 必填规则](https://www.showapi.com/guides/drug-info-detail-search-1468) - **本系列共 11 篇**:查看[药品信息查询指南总目录](https://www.showapi.com/guides/drug-info-guides-1468)