内容审核

业务场景

通过第三方API审核玩家的发言、名字、头像、图片等，并将审核结果返回给CP。 目前，暂时只支持图片地址的审核。

接口地址

https://cp.gzxianc.com/open-api/v1/content/monitor

接口说明

  1. 协议：HTTPS
  2. 方式：POST
  3. ContentType：application/json;charset=utf-8
  4. 请求报文：
字段类型必需参与签名说明
appIdlong是是SDK的appId
openIdstring是是SDK用户唯一标识
serverIdstring是是游戏区服ID
roleIdstring是是游戏角色ID
typeint是是校验类型：1-文本校验 2-图片校验(url格式) 3-图片校验(base64格式)
contentstring是是校验内容，需填写与type对应的值，type为1时长度为1024字符
timestamplong是是毫秒时间戳
signstring是否签名
  1. 响应报文：
字段类型必需说明
codeint是响应状态码
msgstring是响应描述
dataobject是结果数据

data字段

字段类型必需说明
resultint是检查结果: 0-通过, 1-建议审核, 2-不通过
contentstring是文本校验时返回，返回的文本会将屏蔽词屏蔽，其他内容正常
taskIdstring否当次请求的唯一标识

请求示例

{
    "appId": 12345,
    "openId": "1702440114579128657948570",
    "serverId": "1010906",
    "roleId": "101090600239898",
    "type": 2,
    "content": "https://img95.699pic.com/xsj/04/wt/r7.jpg",
    "timestamp": 1757045598339,
    "sign": "d3a6565c6b5eee6b2bca50568a32e7ce"
}

响应示例

{
  "code": 0,
  "msg": "Success",
  "data": {
    "result": 0,
    "content": "",
    "taskId": "cn_bab7d3a2fff24710bb96f00612bbe59b_1757045599474"
  },
  "meta": {
    "tid": "b5f92391"
  }
}

签名规则

  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", 12345);
        params.put("openId", "1702440114579128657948570");
        params.put("serverId", "1010906");
        params.put("roleId", "101090600239898");
        params.put("type", 2);
        params.put("content", "https://img95.699pic.com/xsj/04/wt/r7.jpg");
        params.put("timestamp", 1757045598339L);
        String appKey = "AaBbCcDdEeFfGgHh";
        System.out.println(String.format("签名:%s", getMd5Sign(params, appKey)));
    }
}

状态码

状态码说明
0成功
-1失败，常规性错误
11001无效的参数
11004无效的签名
31012系统繁忙，请稍后再试