基础信息

1. 同步星云游戏服变更信息

1.1 说明
  • 运用于 GM系统-操作工具-游戏服管理，游戏研发可通过此接口获取于星云管理的游戏服信息
  • 若此接口已配置上线，则GM系统中的所有功能，若需使用游戏服信息，将自动使用 “游戏服管理”中的游戏服信息
  • 此接口与“获取游戏当前可用的游戏服列表”接口二选一即可，若已配置上线后者，则无需配置此接口
1.2 请求方式
  • POST
  • Content-Type：application/x-www-form-urlencoded
1.3 请求参数
参数名 类型 长度 说明 是否必传
list string，json格式 - 服务器列表 是

list 参数说明：

参数名 类型 长度 说明 是否必传
is_del int 1 默认0，1表示删除 是
sid string 32 游戏服id 是
name string 50 游戏服名称 是
server_char string 32 集群标识 是
display_time string - 对外展示时间，格式YYYY-MM-DD hh:mm:ss 是
open_time string - 开服时间，格式YYYY-MM-DD hh:mm:ss 是
channel_id_list array - 渠道id列表 是
tag int 1 标签，1正常 2新服 3爆满 4推荐 是
use_status int 1 使用状态，1启用 2停新 3停用 是
maintain_status int 1 维护状态，1正常 2维护 是
deploy_status int 1 部署状态，1未部署 2变更中 3已部署 是
create_time string - 创建时间，格式YYYY-MM-DD hh:mm:ss 是
update_time string - 更新时间，格式YYYY-MM-DD hh:mm:ss 是

list 参数示例：

[
    {
        "is_del": 0,
        "sid": "aaaaaa",
        "name": "221121",
        "server_char": "集群标识",
        "display_time": "2025-10-01 10:00:00",
        "open_time": "2025-10-01 10:00:00",
        "channel_id_list": [
            "1",
            "2"
        ],
        "tag": 1,
        "use_status": 1,
        "maintain_status": 1,
        "deploy_status": 1,
        "create_time": "2025-10-01 10:00:00",
        "update_time": "2025-10-01 10:00:00"
    },
    {
        "is_del": 0,
        "sid": "bbbb",
        "name": "221121",
        "server_char": "集群标识",
        "display_time": "2025-10-01 10:00:00",
        "open_time": "2025-10-01 10:00:00",
        "channel_id_list": [
            "1",
            "2"
        ],
        "tag": "新服",
        "use_status": 1,
        "maintain_status": 1,
        "deploy_status": 1,
        "create_time": "2025-10-01 10:00:00",
        "update_time": "2025-10-01 10:00:00"
    }
]
1.4 返回参数
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":{

    }
}

2. 获取游戏当前可用的游戏服列表

2.1 说明
  • 此接口与“同步星云游戏服变更信息”接口二选一即可，若已对接 GM系统-操作工具-游戏服管理，则无需配置此接口
  • 若此接口已配置上线，则玩家于SDK登录后进入游戏前访问C端客服中心时，可通过此接口选择游戏服
  • GM系统-操作工具 中的所有功能，若需使用游戏服信息，将自动同步此接口信息
2.2 请求方式
  • GET
2.3 请求参数
  • 仅需基础请求参数即可
2.4 返回参数
参数名 类型 长度 说明 是否必传
id string 32 游戏服id 是
name string 50 游戏服名称 是
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":[
        {
            "id":"1",
            "name":"name1"
        },
        {
            "id":"2",
            "name":"name2"
        }
    ]
}

3. 获取游戏当前可用的渠道列表

3.1 说明
  • 若已对接 聚合渠道SDK、已进行 对接中心-渠道打包-渠道配置，则无需配置此接口
  • 若此接口已配置上线，则GM系统-操作工具 中的所有功能，若需使用渠道信息，将自动同步此接口信息
3.2 请求方式
  • GET
3.3 请求参数
  • 仅需基础请求参数即可
3.4 返回参数
参数名 类型 长度 说明 是否必传
id string 32 渠道id 是
name string 50 渠道名称 是
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":[
        {
            "id":"1",
            "name":"name1"
        },
        {
            "id":"2",
            "name":"name2"
        }
    ]
}

4. 获取角色信息（按创角时间降序）

4.1 说明
  • 运用于 GM系统-信息查询-角色信息查询
4.2 请求方式
  • GET
4.3 请求参数
参数名 类型 长度 说明 是否必传
per_page int 11 每页显示条数 是
page int 11 页码 是
pname string 50 角色名称，支持模糊搜索 否
pid string 50 角色ID 否
open_id string 50 用户OpenID 否
did string 32 创角设备id 否
ip string 32 创角ip 否
4.4 返回参数
参数名 类型 长度 说明 是否必传
data.total int 11 总记录数 是
data.list array 1000 玩家信息列表 是
data.list.server_id string 32 游戏服ID 是
data.list.server_name string 50 游戏服名称 是
data.list.channel_id string 32 渠道ID 是
data.list.channel_name string 50 渠道名称 是
data.list.open_id string 32 用户OpenID 是
data.list.pid string 32 角色id 是
data.list.pname string 50 角色名称 是
data.list.level int 11 角色等级 是
data.list.vip_level int 11 角色vip等级 是
data.list.register_time string 50 创角时间，格式YYYY-MM-DD hh:mm:ss 是
data.list.did string 32 创角设备id 是
data.list.ip string 32 创角ip 是
data.list.amount float 32 累计充值金额（单位为元或美元） 是
data.list.recharge_num int 11 累计充值笔数 是
data.list.last_login_time string 32 最后登录时间，格式YYYY-MM-DD hh:mm:ss 是
  • 响应示例：
{
    "status": 1,
    "msg": "success",
    "data": {
        "total": "2",
        "list": [
            {
                "server_name": "游戏服名称1",
                "channel_name": "渠道名称1",
                "server_id": "1",
                "channel_id": "1",
                "open_id": "413bea7eafa0dafe8f76a4544546ae3b",
                "pid": "3245dgh",
                "pname": "角色名1",
                "level": "13",
                "vip_level": "13",
                "register_time": "2025-02-07 14:28:15",
                "did": "3ab0854691d6870bfcfe6c501c3bd78e",
                "ip": "123.207.66.53",
                "amount": "100",
                "recharge_num": "13",
                "last_login_time": "2025-02-07 14:38:15"
            },
            {
                "server_name": "游戏服名称2",
                "channel_name": "渠道名称2",
                "server_id": "2",
                "channel_id": "2",
                "open_id": "413bea7eafa0dafe8f76a4544546ae3b",
                "pid": "3345dgh",
                "pname": "角色名2",
                "level": "11",
                "vip_level": "12",
                "register_time": "2025-02-07 14:28:15",
                "did": "3ab0854691d6870bfcfe6c501c3bd78e",
                "ip": "123.207.66.53",
                "amount": "333",
                "recharge_num": "13",
                "last_login_time": "2025-02-07 14:38:15"
            }
        ]
    }
}

5. 同步星云游戏服准入白名单

5.1 说明
  • 游戏研发可通过此接口获取于 GM系统-操作工具-游戏服管理-准入白名单 配置的准入白名单
  • 注意：星云会异步把准入白名单数据全量推送到该GM接口，研发需自行处理准入白名单用户进入游戏逻辑
5.2 请求方式
  • POST
  • Content-Type：application/x-www-form-urlencoded
5.3 请求参数
参数名 类型 长度 说明 是否必传
whitelist string 20000 聚合OpenID列表，用英文逗号进行分割，最大20000个 是
5.4 返回参数
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":{

    }
}
文章目录