1.通过ulu uid获取角色信息

版本说明：

版本号 日期 说明
V1.0 2023-03-16 初始版本
V2.0 2023-10-10 去掉extraData

简要描述：

  • 功能：通过ulu的uid获取玩家在游戏中的区服角色信息列表。
  • 玩家进行充值需要获取玩家的角色信息。
  • sign签名算法，详情请见1.3 MD5的sign签名算法示例： 签名信息，根据参数名称a-z排序，将参数值拼接后+ secret(密钥) finalString，在进行md5小写加密。

接入要求：

  • 必接

请求URL：

  • 接入方提供

请求方式：

  • POST

请求格式：

  • application/json

请求体参数：

参数名 类型 是否必传 可能为空 说明
userIp long 是 否 用户ip地址，进行十进制处理。值为long类型
userId str 是 否 ulugame为玩家生成的uid，唯一性
gameId int 是 否 ulugame与接入方商定的游戏id
timestamp long 是 否 时间值，精确到毫秒
uluServerEnv int 是 否 发起请求的ulu服务器所处的环境状态：0正式；1非正式
signature str 是 否 签名信息，详情生成规则请看1.3 MD5的sign签名算法示例

请求示例：

{
    "userIp":2130706433,
    "userId":"1199647056789024770",
    "gameId":100160,
    "timestamp":1664118000000,
    "uluServerEnv":1,
    "signature":"db125296fead97fba019c54bcc26fbf0"
}

返回格式：

  • JSON

    返回参数说明

参数名 类型 是否必传 说明
code int 是 状态码,返回0时，视为成功状态
context JsonArray 是 角色的信息集合
msg str 是 返回信息，成功为"success",失败为失败原因

context参数说明

参数名 类型 是否必传 说明
serverId str 是 区服id
serverName str 是 区服名
roleId str 是 角色id
roleName str 是 角色名
extraData str 否 账号透传信息，发货请求时回传过去。可不传

成功返回示例

 {
    "code":0,
    "context":[
        {
            "serverId":"serverId",
            "serverName":"serverName",
            "roleId":"2001001",
            "roleName":"roleName"
        },
        {
            "serverId":"serverId",
            "serverName":"serverName",
            "roleId":"2001001",
            "roleName":"roleName"
        }
    ],
    "msg":"success"
}

{
    "code":0,
    "context": [],
    "msg":"success",
}

失败返回示例

{
    “code”:4001,
    "context": [],
    "msg":"signature is wrong",
}

状态码

code 说明
0 成功

results matching ""

    No results matching ""