02 / 登录 + 转账钱包 APIs
获取 api_key 和 api_secret 后即可开始对接。
Login API 对接完成后,redirect_url 可直接跳转到游戏页面,后续再对接钱包 API 即完成对接。
共有四个 API:
2.1 通用约定
响应字段命名一律为 snake_case(例如 temporary_key、redirect_url、currency_code)。
所有响应都包裹在统一的信封中:
json
{
"code": 0,
"message": "success",
"data": { /* 实际业务回传内容,结构见各 API */ }
}code == 0表示成功,业务数据放在data字段。code != 0表示失败,请参考message。
常见错误码示例:
| code | message | 说明 |
|---|---|---|
| 10000 | authentication failed / missing body-hash in metadata | 签名或 header 不正确 |
| 10020 | ticket_id is required | 缺少必填字段 |
| 10080 | internal server error | 服务器内部错误 |
完整错误对照请参考 常见对接错误对照表。
接下来请阅读 HMAC 验证流程,所有 API(含 GET)都需要正确签名才能调用成功。