内容审核通知

业务场景

人工二次审核玩家的发言、名字、头像图片等,并将审核结果返回给CP,与[内容校验]接口配套使用。

注意事项

时间戳与北京时间差距为 ± 5分钟

流程图

接口地址

地址由CP提供

接口说明

  1. 协议:HTTPS
  2. 方式:POST
  3. ContentType:application/json;charset=utf-8
  4. 请求报文:
字段类型必需参与签名说明
appIdlongSDK的appId
openIdstringSDK用户唯一标识
serverIdstring游戏区服ID
roleIdstring游戏角色ID
taskIdstring内容审核->接口说明->响应报文->data.taskId
extendobject补充内容,不参与签名
timestamplong毫秒时间戳
signstring签名

extend内容

字段类型必需说明
contentstring审核内容
  1. 响应报文:
字段类型必需说明
codeint响应状态码
msgstring响应描述

请求示例

{
	"appId": 10070,
	"openId": "12345678912345678912345",
	"serverId": "40107",
	"roleId": "2700033751",
	"taskId": "9fcc9167",
	"extend": {
		"content": "url"
	},
	"timestamp": 1742214770340,
	"sign": "2b325e9713e7d04283eee1b4f98d3a6f"
}

响应示例

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

签名规则

  1. 参数名区分大小写,按 ASCII 码从小到大排序(字典序)
  2. 只有值为 null 和 参数名不参与签名 的键值对,才不参与签名
  3. 使用 URL 键值对的格式,拼接成待签名字符串,签名 key 在最后拼接,再进行MD5计算
  4. 将生成的签名与入参 sign 值作校验,验签忽略大小写

调试示例

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 Example {

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

    public static void main(String[] args) {
        Map<String, Object> params = Maps.newLinkedHashMap();
        params.put("appId", 10070);
        params.put("openId", "12345678912345678912345");
        params.put("serverId", "40107");
        params.put("roleId", "2700033751");
        params.put("taskId", "9fcc9167");
        params.put("timestamp", 1742214770340L);
        String appKey = "AaBbCcDdEeFfGgHh";
        System.out.println(String.format("签名:%s", getMd5Sign(params, appKey)));
    }
}

状态码

状态码说明
0成功
-1失败,常规性错误
10101查询基础信息失败
10102缺少游戏信息
10103请求参数全部为空
10104缺少签名sign
10105签名不正确
10106timestamp已过期