快速开始

SlaunchX 提供 RESTful API，用于服务端到服务端的集成。所有 API 端点均使用 HMAC-SHA256 签名认证 进行安全访问。

基础 URL

https://api.lampay.app/api/v1/

认证

每个 API 请求必须包含以下四个请求头：

请求头	说明
X-Api-Key	您的 API 密钥标识符（sk_live_xxx）
X-Signature	请求的 HMAC-SHA256 签名
X-Timestamp	Unix 时间戳（秒）
X-Nonce	唯一请求标识符（UUID）

请参阅 认证指南 了解签名计算的详细信息。

快速示例

curl -X GET https://api.lampay.app/api/v1/wallets \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000"

响应格式

所有响应遵循标准信封格式：

200 OK200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "ws_abc123",
    "workspaceName": "My Workspace"
  }
}

字段	类型	说明
version	string	API 版本
timestamp	number	响应时间戳（毫秒级 epoch）
success	boolean	成功时为 true，错误时为 false
code	string	机器可读的状态码
message	string	人类可读的消息
data	object	响应数据（错误时为 null）

错误码

错误码按领域前缀组织。请参阅 错误处理指南 获取完整目录。

前缀	领域
S	系统 / 验证
W	钱包
T	转账
GA	网关认证

分页

列表端点通过查询参数支持分页：

参数	默认值	说明
page	0	页码（从 0 开始）
size	20	每页条目数（最大 100）
sort	不固定	排序表达式（例如 createdAt,desc）

请参阅 分页指南 了解详情。

后续步骤

• 认证指南 — 设置 HMAC-SHA256 签名
• API 参考 — 浏览所有端点
• 错误处理 — 正确处理错误