生成玩家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"
  }
}

results matching ""

    No results matching ""