帮派修改

业务场景

  1. 对违规拉人帮派公告及宣言进行清空，并限制其进行修改

注意事项

  1. 接口需要注意验签，防止恶意请求

接口地址

地址由CP提供

接口说明

  1. 协议：HTTPS
  2. 方式：POST
  3. ContentType：application/json;charset=utf-8
  4. 请求报文：
字段类型必需参与签名说明
serverIdstring是否游戏区服ID
playerIdstring是是帮派ID
timeint是是限制公告及宣言变更时长(分钟)
支持正整数格式,其他为无效参数，为0代表解禁或解封
bpNamestring否否帮派名称
直接输入修改文本，该参数为空时代表保持原有信息不变
bpNoticestring否否帮派公告
直接输入修改文本，该参数为空时代表保持原有信息不变
bpEnouncestring否否帮派宣言
直接输入修改文本，该参数为空时代表保持原有信息不变
timestampint是是毫秒时间戳
signstring是否签名 Key(校验码)由贵方提供
sign的内容是：MD5(校验码playerId=123time=10timestamp=1234567890)
  1. 响应报文：
字段类型必需说明
codeint是响应状态码 0=成功
msgstring否响应描述

请求示例

{
        "serverId": "10158",
        "playerId": "201901051",
        "bpName": "我的帮派",
        "bpNotice": "我的帮派公告",
        "bpEnounce": "我的帮派宣言",
        "time": 10,
        "timestamp": "1654142913840",
        "sign": "3ae039629da605edaec7ae38523ec877"
}

响应示例

{
        "code": 0,
        "msg": "success"
}

签名规则

  1. sign参数不参与签名，将生成的签名与该sign值作校验
  2. 使用URL键值对的格式（即key1=value1key2=value2...）拼接签名字符串
  3. 签名key在前面拼接（即appKey....）
String sign = MD5(appKeyplayerId=123time=10timestamp=1234567890)

调试示例

import cn.hutool.crypto.SecureUtil;
import com.alibaba.nacos.shaded.com.google.common.collect.Maps;

import java.util.Map;
import java.util.TreeMap;

public class NotifyExample {

    public static String getMd5Sign(Map<String, Object> params, String appKey) {
        StringBuilder builder = new StringBuilder(512);
        builder.append(appKey);
        params.forEach((k, v) -> {
            if (v != null) {
                builder.append(k).append("=").append(v);
            }
        });
        return SecureUtil.md5(builder.toString());
    }

    public static void main(String[] args) {
        Map<String, Object> notifyMap = Maps.newLinkedHashMap();
        notifyMap.put("playerId", "201901051");
        notifyMap.put("time", 10);
        notifyMap.put("timestamp", 1654142913840L);
        String appKey = "AaBbCcDdEeFfGgHh";
        System.out.println(String.format("帮派签名:%s", getMd5Sign(notifyMap, appKey)));
    }
}