金店参考价格：常见问题与错误排查（ret_code -1、_id 用法、免费档位）
# 金店参考价格：常见问题与错误排查（ret_code -1、_id 用法、免费档位）
> 接口 2145（金店参考价格）· 免费 · 适用人群：所有调用者 · 阅读时间约 4 分钟
## 核心要点
- 高频问题集中在：_id 从哪来、ret_code -1 怎么解、免费档位限制、更新时间。
- 两步调用（先 2145-1 取 _id，再 2145-2 查价）是排查起点。
- 价格为参考价，展示需标注数据日期。
## Why：这跟我有什么关系
把工单里最高频的几个问题集中作答，便于自助排查，减少无效调用。
## What：前置条件与接口速览
**快速索引**
| 问题 | 答案位置 |
|---|---|
| _id 怎么获取 | Q1 |
| ret_code -1 | Q2 |
| 免费与档位 | Q3 |
| 价格更新时间 | Q4 |
| 铂金价缺失 | Q5 |
| 单位与口径 | Q6 |
## How：接入步骤
如仍需从零接入，参考[5 分钟接入](https://www.showapi.com/guides/gold-price-quickstart-2145) 与[两步调用工作流](https://www.showapi.com/guides/gold-price-two-step-2145)。
## 返回示例与解析
下面直接进入问答。
## 进阶 / 边界
- 排查顺序永远是先确认 2145-1 返回了正确的 _id，再查 2145-2。
## FAQ
**Q：_id 从哪里获取？**
来自「支持金店」接入点（2145-1）返回的 data[]._id。先调 2145-1 拿清单，再用其中某个 _id 调 2145-2。不能自行构造 _id。
**Q：调 2145-2 返回 ret_code -1 是什么？**
表示没有找到该 _id 对应的品牌。最常见原因是 _id 抄错或品牌已下架。回到 2145-1 重新拉清单核对最新 _id 即可。
**Q：接口真的免费吗，有调用限制吗？**
注册后默认可免费调用；为防止滥用设有使用档位限制，权益档次可用平台积分兑换更高调用档位。具体档位数字以官方档位说明为准。
**Q：金价每天几点更新？**
最新价格接入点（2145-2）每天 13:40 更新；支持金店（2145-1）品牌清单为每年不定期更新一次。auLastDate/ptLastDate 是报价日期。
**Q：platinumPrice 有时拿不到？**
部分品牌可能未提供铂金价，该字段会缺失或为空。展示时做空值兜底，不要当成接口报错。
**Q：goldPrice 的单位是元/克吗？**
文档示例 goldPrice=869、platinumPrice=409，按行业惯例为元/克，但文档未显式标注单位；展示时建议注明「参考价」并保留数据日期。
## 相关能力 / 下一步阅读
- [金店参考价格：返回字段与状态码全解](https://www.showapi.com/guides/gold-price-response-codes-2145)
- [金店参考价格：两步调用工作流](https://www.showapi.com/guides/gold-price-two-step-2145)
- [金店参考价格：最新价格接入点（2145-2）使用指南](https://www.showapi.com/guides/gold-price-latest-price-2145)
- **本系列共 12 篇**：查看[金店参考价格 · 官方指南总目录](https://www.showapi.com/guides/gold-price-guides-2145)
