# 药品参考价格(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)