内容审核通知
业务场景
人工二次审核玩家的发言、名字、头像图片等,并将审核结果返回给CP,与[内容校验]接口配套使用。
注意事项
时间戳与北京时间差距为 ± 5分钟
流程图
接口地址
地址由CP提供
接口说明
- 协议:HTTPS
- 方式:POST
- ContentType:application/json;charset=utf-8
- 请求报文:
字段 | 类型 | 必需 | 参与签名 | 说明 |
---|---|---|---|---|
appId | long | 是 | 是 | SDK的appId |
openId | string | 是 | 是 | SDK用户唯一标识 |
serverId | string | 是 | 是 | 游戏区服ID |
roleId | string | 是 | 是 | 游戏角色ID |
taskId | string | 是 | 是 | 内容审核->接口说明->响应报文->data.taskId |
extend | object | 否 | 否 | 补充内容,不参与签名 |
timestamp | long | 是 | 是 | 毫秒时间戳 |
sign | string | 是 | 否 | 签名 |
extend内容
字段 | 类型 | 必需 | 说明 |
---|---|---|---|
content | string | 否 | 审核内容 |
- 响应报文:
字段 | 类型 | 必需 | 说明 |
---|---|---|---|
code | int | 是 | 响应状态码 |
msg | string | 否 | 响应描述 |
请求示例
{
"appId": 10070,
"openId": "12345678912345678912345",
"serverId": "40107",
"roleId": "2700033751",
"taskId": "9fcc9167",
"extend": {
"content": "url"
},
"timestamp": 1742214770340,
"sign": "2b325e9713e7d04283eee1b4f98d3a6f"
}
响应示例
{
"code": 0,
"msg": "success"
}
签名规则
- 参数名区分大小写,按 ASCII 码从小到大排序(字典序)
- 只有值为 null 和 参数名不参与签名 的键值对,才不参与签名
- 使用 URL 键值对的格式,拼接成待签名字符串,签名 key 在最后拼接,再进行MD5计算
- 将生成的签名与入参 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 | 签名不正确 |
10106 | timestamp已过期 |