按药名查药品：药名查询药品信息（1468-4）实战指南
# 按药名查药品：药名查询药品信息（1468-4）实战指南
- **接口/接入点**：药品信息查询（apiCode=1468）· 1468-4 药名查询药品信息
- **是否免费**：免费（有档位限制）
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：全栈工程师、产品经理
- **阅读时间**：约 4 分钟
## 核心要点
- 1468-4 是「按药名模糊检索」入口：只传 `searchKey`（药名）即可返回匹配的 `drugList[]`（说明书级详情）。
- 参数全为可选（`searchKey`/`page`/`maxResult`），但**建议始终传 `searchKey`**，否则结果不可预期。
- 返回结构与 1468-3 完全相同，差异仅在参数：1468-4 不需要 `searchType` 与 `classifyId`。
## Why：什么时候用 1468-4 而不是 1468-3
用户直接在搜索框输入「阿司匹林」想看说明书，这种「只知道药名、不想选类型」的场景用 1468-4 最顺手。1468-3 更适合「我已明确按药准字号/药企精确检索」的情况。
## What：接口速览
| 项 | 说明 |
|------|------|
| 调用地址 | `https://route.showapi.com/1468-4?appKey=YOUR_APPKEY` |
| 必填参数 | 无（推荐传 `searchKey`） |
| 可选参数 | `searchKey`(关键字)、`page`(当前页)、`maxResult`(默认 10) |
| 返回 | `drugList[]`（同 1468-3 字段，见[字段全解](https://www.showapi.com/guides/drug-info-fields-1468)） |
## How：按药名检索
```python
import requests
APPKEY = "YOUR_APPKEY"
r = requests.post(
"https://route.showapi.com/1468-4",
data={"appKey": APPKEY, "searchKey": "阿司匹林", "page": "1", "maxResult": "10"},
timeout=10,
)
body = r.json()["showapi_res_body"]
if body.get("ret_code") == "0":
for d in body["drugList"]:
print(d["drugName"], "|", d["manu"], "|", d["pzwh"])
```
```bash
curl -X POST "https://route.showapi.com/1468-4?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "searchKey=%E9%98%BF%E5%8F%B8%E5%8C%B9%E6%9E%97&page=1&maxResult=10"
```
```javascript
const APPKEY = "YOUR_APPKEY";
const fd = new URLSearchParams({ searchKey: "阿司匹林", page: "1", maxResult: "10" });
fetch(`https://route.showapi.com/1468-4?appKey=${APPKEY}`, { method: "POST", body: fd })
.then((r) => r.json())
.then((j) => console.log(j.showapi_res_body.drugList));
```
## 返回示例与解析
返回 `drugList[]` 元素含 `tymc`(通用名)、`drugName`、`manu`(生产企业)、`pzwh`(批准文号)、`syz`(适应症)、`yfyl`(用法用量)、`type`(分类数组) 等。`count` 为命中总数。
## 进阶 / 边界
- `searchKey` 建议传药名的通用名称（如「阿司匹林」），模糊匹配；若需按药准字号/药企精确查，改用 [1468-3](https://www.showapi.com/guides/drug-info-detail-search-1468)。
- 不传 `searchKey` 时返回不可预期，生产环境务必校验入参非空。
- 返回字段结构细节见[字段全解](https://www.showapi.com/guides/drug-info-fields-1468)。
## FAQ
**Q1：1468-4 和 1468-3 返回一样，用哪个？**
A：返回结构相同；1468-4 只需药名（适合模糊搜索框），1468-3 需指定 searchType 且可带 classifyId（适合精确/分类内检索）。按你的输入条件选。
**Q2：searchKey 不传会怎样？**
A：文档将其标为「否」，但生产环境建议必传；不传时结果不可预期，不宜依赖。
**Q3：返回数量太多怎么翻页？**
A：用 `page` 翻页，`maxResult` 控制单页条数（默认 10）。命中总数见 `count`。
## 相关能力 / 下一步阅读
- [药品详细信息检索：searchType 四种类型与 classifyId 必填规则](https://www.showapi.com/guides/drug-info-detail-search-1468)
- [药品信息查询返回字段全解](https://www.showapi.com/guides/drug-info-fields-1468)
- [药品信息查询：5 分钟快速接入指南](https://www.showapi.com/guides/drug-info-quickstart-1468)
- **本系列共 11 篇**：查看[药品信息查询指南总目录](https://www.showapi.com/guides/drug-info-guides-1468)
