金店参考价格「支持金店」接入点（2145-1）使用指南
# 金店参考价格「支持金店」接入点（2145-1）使用指南
> 接入点 2145-1（支持金店）· 免费 · 请求方式 POST/GET · 返回 JSON · 阅读时间约 3 分钟
## 核心要点
- 2145-1 返回受支持的金店品牌清单（data[]，每项含 _id 与 brand）。
- 该清单是查实时价的前置步骤，也是全品牌遍历的起点。
- 清单更新频率低（每年不定期），适合本地缓存。
## Why：这跟我有什么关系
金店参考价格的「支持金店」接入点告诉你：这个接口现在覆盖哪些金店。它不直接给价格，但给的 _id 是查价的钥匙。
## What：前置条件与接口速览
**接入点信息**
| 项 | 值 |
|---|---|
| 接入点 | 支持金店（2145-1） |
| 地址 | `https://route.showapi.com/2145-1?appKey={your_appKey}` |
| 请求方式 | POST / GET |
| 必填参数 | 无（仅 Header content-type，选填） |
| 更新频率 | 每年不定期更新一次 |
| 返回 | data[]（_id + brand） |
## How：接入步骤
**调用示例**
```python
import requests
url = "https://route.showapi.com/2145-1"
resp = requests.post(
url,
params={"appKey": "YOUR_APPKEY"},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=10,
)
data = resp.json()
if data.get("showapi_res_code") == 0 and data["showapi_res_body"]["ret_code"] == 0:
for item in data["showapi_res_body"]["data"]:
print(item["_id"], item["brand"])
else:
print("查询失败:", data.get("showapi_res_error"))
```
```bash
curl -X POST "https://route.showapi.com/2145-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded"
```
## 返回示例与解析
**返回示例**
```python
{
"showapi_res_error": "",
"showapi_fee_num": 1,
"showapi_res_code": 0,
"showapi_res_id": "67a5aa89fb638c27e149bc47",
"showapi_res_body": {
"ret_code": 0,
"data": [
{ "_id": "5da958e9d3fb8b0eefc6a3d1", "brand": "潮宏基" }
]
}
}
```
`data` 为数组，每个元素 `{_id, brand}`。把 `_id` 传给 2145-2 即可查该品牌金价。
## 进阶 / 边界
- 清单更新频率低，可在服务端缓存一天甚至更久，减少重复调用。
- 文档示例仅列出一个品牌（潮宏基），真实返回是完整受支持品牌数组。
- 查全部品牌金价见[高并发/批量架构](https://www.showapi.com/guides/gold-price-architecture-2145)。
## FAQ
**Q：返回的品牌数量固定吗？**
不固定，随接口覆盖品牌调整；清单每年不定期更新一次，以实时返回为准。
**Q：2145-1 需要传参数吗？**
不需要业务参数，仅可选 Header content-type。直接请求即可拿到品牌数组。
**Q：_id 会变吗？**
品牌下架或调整时 _id 可能变化，因此不要写死，每次用时从 2145-1 现取。
## 相关能力 / 下一步阅读
- [金店参考价格：最新价格接入点（2145-2）使用指南](https://www.showapi.com/guides/gold-price-latest-price-2145)
- [金店参考价格：两步调用工作流](https://www.showapi.com/guides/gold-price-two-step-2145)
- [金店参考价格：返回字段与状态码全解](https://www.showapi.com/guides/gold-price-response-codes-2145)
- **本系列共 12 篇**：查看[金店参考价格 · 官方指南总目录](https://www.showapi.com/guides/gold-price-guides-2145)
