环境
SlaunchX 提供两个独立的 API 集成环境：用于开发和测试的沙盒环境，以及用于正式运营的生产环境。两个环境暴露相同的 API 接口和认证机制，但数据、API 密钥和配置完全隔离，互不相通。
环境 URL
| 沙盒环境 | 生产环境 | |
|---|---|---|
| API 基础 URL | https://sandbox. | https:// |
| 管理面板 | https://sandbox.dashboard.slaunchx.cc | https://dashboard.slaunchx.cc |
| 用途 | 开发、测试、QA | 正式交易、真实资金 |
| 数据 | 模拟数据，可重置 | 持久化，真实数据 |
从沙盒开始
请始终在沙盒环境中构建和测试您的集成。仅在端到端验证通过后再切换到生产环境。
认证
两个环境使用相同的 HMAC-SHA256 认证机制。但 API 密钥是环境隔离的——沙盒密钥无法在生产环境中使用，反之亦然。
| 项目 | 沙盒环境 | 生产环境 |
|---|---|---|
| API Key 前缀 | sk_test_ | sk_live_ |
| API Secret | 每个环境独立 | 每个环境独立 |
| 认证机制 | HMAC-SHA256 | HMAC-SHA256 |
您可以在各自的管理面板中独立生成和管理每个环境的 API 密钥。
沙盒功能
沙盒环境专为安全、无风险的开发而设计：
- 模拟交易 -- 所有转账和钱包操作均为模拟，不会移动真实资金。
- 测试数据 -- 预置的测试钱包和账户可供直接使用。
- 即时处理 -- 在生产环境中可能耗时的交易，在沙盒中会即时完成。
- 可重置状态 -- 可通过管理面板重置沙盒数据，不影响生产环境。
- 完整 API 覆盖 -- 生产环境的所有端点在沙盒中均可用，请求/响应格式完全一致。
测试凭证
获取沙盒 API 密钥
- 登录沙盒管理面板。
- 导航至 设置 > API 密钥。
- 点击 创建 API 密钥，分配所需的权限范围。
- 复制 API 密钥（
sk_test_...）和 API Secret。Secret 仅显示一次。
测试钱包
沙盒环境预置了测试钱包。您也可以通过 API 或管理面板创建额外的钱包。所有沙盒钱包都有可配置的测试余额。
测试卡号 / 钱包地址
如果您的集成涉及外部支付方式，沙盒中提供以下测试值：
| 类型 | 值 | 行为 |
|---|---|---|
| 测试钱包（成功） | 预置的 w_test_* 钱包 | 交易正常成功 |
| 测试钱包（余额不足） | 余额为零的钱包 | 返回 W3001（INSUFFICIENT_BALANCE） |
| 测试钱包（已冻结） | 已冻结的测试钱包 | 返回 W1003（ACCOUNT_FROZEN） |
与生产环境的差异
虽然沙盒尽可能贴近生产环境，但仍存在以下差异：
| 方面 | 沙盒环境 | 生产环境 |
|---|---|---|
| 速率限制 | 更宽松 | 标准速率限制 |
| 数据持久性 | 可能定期重置 | 完全持久化 |
| Webhook | 发送到您配置的端点，格式相同 | 相同 |
| 交易处理 | 即时，模拟 | 真实处理时间 |
| 监控与告警 | 有限 | 完整的运营监控 |
:::caution 沙盒数据非永久性 沙盒数据可能在维护窗口期间被重置。请勿依赖沙盒数据进行长期存储或记录保存。 :::
上线检查清单
在将集成从沙盒切换到生产环境之前，请完成以下步骤：
更换 API 密钥 -- 将
sk_test_凭证替换为sk_live_生产凭证。切勿硬编码密钥，请使用环境变量或密钥管理服务。更新基础 URL -- 将 API 基础 URL 从
https://sandbox.更改为https://。验证 Webhook 端点 -- 确保您的生产 Webhook 接收端已部署、可公开访问，并已在生产管理面板中配置。
小额真实交易测试 -- 执行几笔小额交易以确认端到端正确性，然后再进行大规模处理。
启用生产监控 -- 为 API 错误（
5xx响应）、延迟峰值和 Webhook 投递失败设置告警。检查 IP 白名单 -- 如果使用 IP 白名单，确保您的生产服务器 IP 已添加到生产 API 密钥配置中。
确认幂等性处理 -- 验证您的重试逻辑使用幂等键，以防止在生产环境中产生重复交易。
代码示例
环境感知的客户端配置，根据配置在沙盒和生产环境之间切换：