02 / 登录 + 转账钱包 APIs

获取 api_key 和 api_secret 后即可开始对接。

API 域名：https://gateway-api.bwsh7twk.com/

Login API 对接完成后，redirect_url 可直接跳转到游戏页面，后续再对接钱包 API 即完成对接。

共有四个 API：

• 登录 API
• 余额查询 API
• 钱包转入 / 转出 API

2.1 通用约定

响应字段命名一律为 snake_case（例如 temporary_key、redirect_url、currency_code）。

所有响应都包裹在统一的信封中：

{
  "code": 0,
  "message": "success",
  "data": { /* 实际业务回传内容，结构见各 API */ }
}

• code == 0 表示成功，业务数据放在 data 字段。
• code != 0 表示失败，请参考 message。

时间格式

所有时间字段均为 RFC3339 UTC（例 2026-05-19T00:00:00Z），但小数秒位数不固定，请一律使用通用 RFC3339 parser 解析，勿以固定长度的字符串格式比对或截断。

来源字段	精度
注单查询 order_time、updated_at	整秒，无小数
注单查询 trades[].settled_time	至毫秒
钱包转入 / 转出、钱包记录 created_at	最高至纳秒

时间字段为空时输出 null，不会省略该字段。

常见错误码示例

code	message	说明
10000	authentication failed / missing body-hash in metadata	签名或 header 不正确
10020	ticket_id is required	缺少必填字段
10080	internal server error	服务器内部错误

完整错误对照请参考 常见对接错误对照表。

接下来请阅读 HMAC 验证流程，所有 API（含 GET）都需要正确签名才能调用成功。