金店参考价格：高并发 / 批量集成架构（缓存 + 限流 + 定时拉取，无异步回调）
# 金店参考价格：高并发 / 批量集成架构（缓存 + 限流 + 定时拉取，无异步回调）
> 接口 2145（金店参考价格）· 免费 · 同步请求模型 · 适用人群：中大型平台、架构师 · 阅读时间约 6 分钟
## 核心要点
- 本接口是同步请求模型，无订阅推送 / 回调 / 批量订阅能力。
- 高并发正确姿势：本地缓存 + 令牌桶限流 + 每天 13:40 后定时全量预热。
- 前端读本地库，接口只做「回源 + 写缓存」，彻底解耦峰值。
## Why：这跟我有什么关系
日调用量大的平台（如金价聚合站、珠宝 SaaS）不能每次用户请求都打接口。本接口没有异步回调，所以架构要围绕「客户端缓存 + 定时拉取」设计。
## What：前置条件与接口速览
**能力边界（务必如实）**
| 能力 | 是否支持 |
|---|---|
| 同步请求（POST/GET） | ✅ |
| 订阅推送 / 回调 | ❌ 不支持 |
| 批量订阅接入点 | ❌ 不支持 |
| MCP / OpenAPI 集成 | ✅ |
因此不要设计「订阅后等回调」的链路，而用「定时拉取 + 本地存储」。
## How：接入步骤
**推荐架构**
```
[定时任务 13:50] --遍历 2145-1 的 _id--> 逐个调 2145-2 --> 写入本地 DB/缓存
|
v
[用户请求] --> 读本地 DB（不经过 showapi.com）--> 返回金价
[缓存未命中/过期] --> 令牌桶限流后回源 2145-2 --> 写缓存
```
**令牌桶限流（Python 伪代码）**
```python
from time import sleep
import requests
def fetch_with_limit(brand_ids, appkey, rate_per_sec=5):
for bid in brand_ids:
# 简单限流：每 1/rate 秒一个，避免触发档位限流
body = requests.post("https://route.showapi.com/2145-2",
params={"appKey": appkey},
data={"id": bid}, timeout=10).json()["showapi_res_body"]
save_to_db(bid, body) # 写入本地
sleep(1.0 / rate_per_sec)
```
## 返回示例与解析
**数据流说明**
- 预热任务每天 13:50（跨过 13:40 更新点）跑一次，全量拉取所有品牌金价落本地库。
- 用户侧只读本地库，零接口依赖、零延迟。
- 仅在缓存失效时按令牌桶限流回源，保护档位。
## 进阶 / 边界
- 不要期待「推送/回调」：本接口无此能力，任何异步架构都需自建定时拉取。
- 全品牌 N 次调用请放在低峰批量执行，避免白天峰值触发免费档位限流。
- 展示金价时标注「参考价 / 数据日期 auLastDate」，避免用户误当实时行情。
## FAQ
**Q：支持 WebSocket / 推送吗？**
不支持。本接口为同步请求模型，没有订阅推送或回调能力，需用定时拉取自建更新。
**Q：批量查询有专门接入点吗？**
没有。需自行遍历 2145-1 的 _id 逐个调 2145-2，并做好限流。
**Q：本地库和接口价格不一致怎么办？**
确保定时预热跨过每天 13:40 更新点，并给缓存设置合理 TTL；展示时带数据日期便于核对。
## 相关能力 / 下一步阅读
- [金店参考价格：金价每日 13:40 更新，如何设计缓存策略](https://www.showapi.com/guides/gold-price-cache-cost-2145)
- [金店参考价格：多语言调用示例](https://www.showapi.com/guides/gold-price-code-examples-2145)
- [金店参考价格：返回字段与状态码全解](https://www.showapi.com/guides/gold-price-response-codes-2145)
- **本系列共 12 篇**：查看[金店参考价格 · 官方指南总目录](https://www.showapi.com/guides/gold-price-guides-2145)
