生成玩家token
该API接口由游戏平台提供,供商户(运营商)进行调用。
转账钱包第一步,生成用户在平台游戏中使用的token。该接口会生成一个新的玩家鉴权的token,生成的token七天有效,七天后可以再调用这个接口获取新的token,旧的token会立即失效,建议商户对这个token做一个管理token过期在重新获取。
在后续的转账、查询余额、查询转账状态接口调用中,都需要这个token,否则会鉴权失败,介入方可以根据返回的过期时间(UTC格式)判断是否过期,马上要过期了,调用此接口生成新token,可实现玩家无感知切换token。
请求地址
POST {API_URL_ROOT}/auth/createToken
Request参数
Header内容
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sign | 是 | string | 签名,使用签名算法计算得到 |
| timestamp | 是 | int | UTC时间戳,单位秒,从1970年1月1日到现在所经过的秒数,如:1741837297 |
| Accept-Language | 是 | string | 接收的语言编码,参考语言列表,如:zh,en,以便在报错的时候,提供响应的语言错误信息。 |
| Content-Type | 是 | string | "application/json; charset=utf-8" |
BODY内容 **
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| tenantId | 是 | int | 商户ID, 平台给你分配的唯一的整数 |
| userId | 是 | string | 商户的玩家ID, 能够区分每一个玩家的ID |
| currency | 否 | string | 币种,如果商户是多币种,此栏位必填 |
示例
{
"tenantId": 1,
"userId": "t1_225478",
"currency": "BRL"
}
Response参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 鉴权token |
| expires | 否 | DateTime | 过期时间,UTC时间 |
示例
{
"isSuccess": true,
"code": 0,
"data": {
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWQiOiI2N2QzYzM5NzFlN2NhNDYxNWRhZWQxMjUiLCJzdWIiOiJ0MV8yMjU0NzgiLCJ0ZW5hbnQiOiIxIiwibmJmIjoxNzQxOTMxNDE1LCJleHAiOjE3NDIwMTc4MTUsImlzcyI6InRoZWEiLCJhdWQiOiJ0aGVhIn0.L1OQa7cF0iFeGXwM1yd7nMeoiHk17EwkmWO_egJxGhQMrTzvcYTgnyJjZF9RH4dx-OPtbvMzZIjf7mV1C2mcV-s2ya_GNrf_6JlRONBzuRuOlAgD_PRWmdptuyPd8cH5n0IXENMOZ3xQ4W2MIy1EMw7snKIJXuMscC82ZsrDEqQ",
"expires": "2025-03-15 05:50:15"
}
}