快速入门
概述
VCT 游戏集成平台为 Agent 提供了统一的 Open API,整合了 BG (Big Gaming)、GSC、SA Gaming、WM Casino 四家游戏商的接口能力。
所有接口均需要通过 自定义 Token 进行身份验证。
环境地址
| 环境 | Base URL |
|---|---|
| 生产环境 | https://api.vct-gaming.com |
| 测试环境 | https://staging-api.vct-gaming.com |
凭证说明
每个 Agent 分配一对唯一的 API 凭证:
| 字段 | 说明 | 用途 |
|---|---|---|
agent_api_key | API Key(公开标识符) | Token 中的身份标识,明文传输 |
agent_api_secret | API Secret(私密密钥) | HMAC-SHA256 签名密钥,不在 Token 中出现 |
安全警告
agent_api_secret 仅用于服务端签名,绝不能暴露在前端代码、日志或公共仓库中。
通用请求头
| Header | 值 | 说明 |
|---|---|---|
Authorization | Bearer {token} | Agent Token(必填) |
Content-Type | application/json | 请求体格式 |
通用响应格式
json
{
"code": 0,
"message": "success",
"data": { ... },
"timestamp": 1711411200000,
"request_id": "req_xxxxxxxxxxxx"
}| 字段 | 类型 | 说明 |
|---|---|---|
code | int | 状态码,0 = 成功,非 0 = 失败 |
message | string | 状态描述 |
data | object | 业务数据 |
timestamp | long | 响应时间戳(毫秒) |
request_id | string | 请求唯一标识,用于排查问题 |