环境说明
环境列表
| 环境 | API 基础地址 | 说明 |
|---|---|---|
| 沙箱环境 | https://sandbox-openapi.example.com | 测试数据，可自由调试 |
| 生产环境 | https://openapi.example.com | 真实数据，需审核通过 |
沙箱环境
沙箱环境提供与生产环境完全一致的API接口，使用模拟数据：
- 不限制 IP 白名单
- 独立的测试数据，可随时重置
- 回调通知正常推送
- 调用频率限制与生产环境一致
测试数据
沙箱环境预置了以下测试数据：
| 数据类型 | 说明 |
|---|---|
| 测试商户 | 预置5个不同类型的测试商户 |
| 测试门店 | 每个测试商户下2-3个门店 |
| 会员卡模板 | 多种类型的会员卡模板 |
| 商品/服务 | 各类型商品和服务数据 |
生产环境
生产环境对接真实商户数据，请注意：
- 必须配置 IP 白名单
- 所有数据操作均会生效
- 请确保已在沙箱环境充分测试
- API 调用受限流策略控制
版本管理
API 采用 URL 路径版本化：
https://openapi.example.com/v1/merchants # v1 版本
https://openapi.example.com/v2/merchants # v2 版本（如有）- 当前稳定版本为
v1 - 新版本发布后，旧版本至少维护 12个月
- 版本废弃前 3个月 发布公告通知