通过Smart Money API全面的沙盒环境掌握测试技巧。使用真实的测试数据、确定性响应和宽松的速率限制进行无风险开发实验。
Smart Money API提供功能完备的沙盒环境用于开发和测试。沙盒镜像了生产API结构,但使用合成数据和宽松的速率限制,让您在上线前能自信开发。
主要特性:
最佳实践: 所有开发、测试和预发布都应使用沙盒环境。仅在通过充分沙盒验证后使用生产环境。
沙盒包含不会随机变化的真实加密货币市场数据:
通过控制台创建测试账户以生成沙盒API密钥:
使用以下公开测试密钥快速体验(受速率限制):
| 密钥 | 权限 | 限制 |
|---|---|---|
| sk_test_demo | 只读权限 | 100次/小时 |
| sk_test_trader | 读取+警报 | 500次/小时 |
| sk_test_pro | 完全访问 | 5000次/小时 |
切勿在生产环境使用测试密钥。 它们功能有限且受速率限制。
沙盒包含以下具有真实历史数据的测试交易对:
具有确定性行为的预配置测试钱包:
| 端点 | 用途 |
|---|---|
| POST /test/reset | 重置测试数据至初始状态 |
| POST /test/inject-error | 注入特定错误以进行测试 |
| POST /test/simulate-time | 模拟不同市场条件 |
| GET /test/status | 检查沙盒环境健康状态 |
强制返回特定错误响应以测试异常处理:
| 错误代码 | HTTP状态码 | 使用场景 |
|---|---|---|
| invalid_key | 401 | 认证错误处理 |
| rate_limit_exceeded | 429 | 退避逻辑测试 |
| not_found | 404 | 缺失资源处理 |
| service_unavailable | 503 | 重试逻辑测试 |
| timeout | 504 | 超时处理 |
| 环境 | 限制/小时 | 突发流量 | 用途 |
|---|---|---|---|
| 沙盒 | 10,000 | 500/分钟 | 开发与测试 |
| 生产环境免费版 | 1,000 | 50/分钟 | 业余项目 |
| 生产环境交易版 | 10,000 | 400/分钟 | 专业交易 |
| 生产环境专业版 | 50,000 | 1000/分钟 | 高频系统 |
在沙盒中测试完整工作流后再部署至生产环境:
使用环境变量在沙盒和生产环境之间切换:
问题: 使用测试密钥时收到401未授权错误
解决方案:
问题: POST /test/reset后测试数据未重置
解决方案:
问题: 在沙盒中遇到速率限制(不应发生)
解决方案: