获取角色最后登录时间

接口使用范围：

选接，参与到ulu活动时接入。

版本说明：

版本号 日期 说明
V1.0 2022-07-05 初始版本

简要描述：

  • 功能：通过角色id+区服id查询最后成功登录游戏的时间。
  • 查询前，cp需判断角色id是否存在。
  • sign签名算法，详情请见6.1 MD5的sign签名算法示例： 签名信息，根据参数名称a-z排序，将参数值拼接后+ secret(密钥) finalString，在进行md5加密，例如：md5（cycle+gameId+giftCode+...+uid+secret）。

请求URL：

  • CP方提供

请求方式：

  • POST

请求格式：

  • JSON

请求体参数：

参数名 类型 是否必传 说明
gameId int 是 ulugame 提供的游戏id
serverId str 否 区服id
roleId str 是 角色id
sandbox str 是 发起本次请求的平台环境：0:正式环境，1:沙盒环境
cpExtraData obj 否 cp提供的透传参数常量，有就提前告知并传递，没有就不传
signature str 是 签名信息，详情生成规则请看6.1 MD5的sign签名算法示例

请求示例：

{
    "gameId":100163,
    "serverId":"121",
    "roleId":"1199647056789024770",
    "cpExtraData":"ULU",
    "sandbox":1,
    "signature":"4f065a34cc964a42f87787e2b44935bc"
}

返回格式：

  • JSON

    返回参数说明

参数名 类型 是否必传 说明
code int 是 状态码,请看详细说明.只有0才算成功。
msg str 是 返回信息，成功为"success",失败为失败内容
actionData str 是 行为数据，指角色名,查询错误时可不返回。
lastActionTs int 是 最后行为时间，指登录时间，时间戳，毫秒级。,查询错误时可不返回。

成功返回示例

{
    “code”:0,
    "actionData": "roleName",
    "lastActionTs":1645167002777,
    "msg":"signature is wrong",
}

失败返回示例

{
    “code”:4001,
    "serverList": "null",
    "msg":"signature is wrong",
}

状态码

code 说明
0 成功
4001 签名错误，详情可通过msg传递
4002 查询不到该游戏，详情可通过msg传递
4003 参数不全，详情可通过msg传递
4005 角色信息不存在，角色id错误。

results matching ""

    No results matching ""