礼包码下发


监控后台封禁API说明

[TOC]

1、封禁API

1.1 请求地址

http://chat.llewan.com/v1/ChatLimit/set

1.2 请求方式
  • POST application/x-www-form-urlencoded
1.3 请求参数
参数名 必含 类型 说明
game_id string 乐玩平台子游戏标识(马甲包),如xxx-weixn
user_id   string 角色ID
server_id string 区服ID
user_name string 角色昵称
player_id string 用户ID
type integer 操作类型,1:禁言,2:封号(按账号维度封禁,同时让角色下线),3:解除禁言,4:解除封号
limit_time integer 封禁时间,单位:min
timestamp integer 发起请求时间戳,单位:s
sign string 签名,签名方式见下说明
响应结果说明
  • 响应结果示例
// 成功
{"code":1,"msg":"success","d":[]}

// 异常
{"code":-1,"msg":"check sign fail","d":[]}

2、查询角色信息

2.1 请求地址

http://chat.llewan.com/v1/ChatLimit/getRoleInfo

2.2 请求方式
  • GET
2.3 请求参数
参数名 必含 类型 说明
game_id string 乐玩平台子游戏标识(马甲包),如xxx-weixn
user_id   string 角色ID,多个角色用英文逗号【,】分隔,最多支持一次查询100个角色
timestamp integer 发起请求时间戳,单位:s
sign string 签名,签名方式见下说明
2.4 响应结果说明
参数名 必含 类型 说明
code integer 状态码:1成功,-1异常
msg   string 响应结果说明
d object 响应结果数据
d.roles object 角色信息列表,响应成功时返回
d.roles.player_id string 用户ID,成功时返回
d.roles.role_id string 角色ID,成功时返回
d.roles.server_id string 服务器ID,成功时返回
d.roles.server_name string 服务器名称,成功时返回
d.roles.last_login_time integer 最后登录时间,时间戳,单位:s
d.roles.create_time integer 角色注册时间,时间戳,单位:s
  • 响应结果示例
// 成功
{"code":1,"msg":"success","d":{"roles":{"492583356731710":{"player_id":8,"server_id":"560001","server_name":"","role_id":"492583356731710","role_name":"S1.戒躁┗汉正","last_login_time":0,"create_time":1586200000},"492583356731711":{"player_id":9,"server_id":"560001","server_name":"","role_id":"492583356731711","role_name":"S1.北觅№文蓓","last_login_time":0,"create_time":1586200000}}}}

// 异常
{"code":-1,"msg":"check sign fail","d":[]}

- 签名方式说明

  • 参与签名字段说明 以上请求参数除sign外都需要参与签名
  • 签名规则 1、签名串规则:所有参与签名的参数,按参数名(key)字典序升序排序,以key=value格式,并用【&】连接组成签名串,最后连接服务端签名秘钥 2、对签名串进行MD5加密得到签名(32位小写字符串),PHP示例如下:
<?php

function getSign($params, $secret)
{
    //剔除sign字段
    if (isset($params['sign'])) unset($params['sign']);

    //对数组按key升序排序
    ksort($params);

    //拼接签名串
    $formatStr = '';
    foreach ($params as $key => $v) {
        $formatStr .= $key . '=' . $v . '&';
    }
    return md5(substr($formatStr, 0, -1) . $secret);
}

$secret = 'abc'; //服务端签名秘钥
$params = [
    'game_id'     => 'aaa-weixin',
    'role_id'     => '1520001',
    'server_id' => '10001',
    'user_name' => '昵称',
    ...
]; //请求参数
$sign = getSign($params, $secret); //签名

页面列表

ITEM_HTML