接口说明

本接口用于上报应用的举报信息，需要客户申请智能风控服务，获取到产品密钥及业务ID。接口支持客户上报应用的举报信息，开通功能并且上报举报信息后，易盾智能风控系统将基于举报信息进行分析，反馈应用/游戏环境。

鉴权说明

易盾智能风控服务使用签名认证方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5签名算法，详细信息请参见接口鉴权。

接入须知

举报信息统计仅为客户提供更加便捷的应用/游戏环境感知能力，并不涉及外挂、作弊检测及验证。请控制接口调用频率，频率过高，可能会超过频率限制，导致上报失败，建议QPS不超过1000。

请求说明

请求地址

名称	值
HTTP URL	http://ir-open.dun.163.com/v5/risk/reportData
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："Content-Type:application/json"

 

请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见公共请求参数；接口参数如下：

参数	类型	必填	最大长度	描述
reportChannel	String	否	64	用户/玩家举报的渠道/入口（如应用/游戏举报入口、官网举报渠道等），由客户自定义，如只有一个渠道/入口，可传入固定值
reportTime	Number	是	13	举报时间，Unix时间戳（毫秒）
whistleblower	String	是		举报人信息，json格式字符串，具体字段详情见举报人。
reportedPerson	String	是		被举报人信息，json格式字符串，具体字段详情见被举报人。
reportType	String	否	64	举报类型，如辱骂、作弊、开挂等，由客户自定义（建议传入类型中文字符串）
reportScene	String	否	32	举报场景/地点，用户/玩家举报时所处应用场景，如在战斗场景、聊天场景等，由客户自定义
reportData	String	否	256	举报内容详情，用户/玩家举报时，输入的详情描述

举报人

参数	类型	必填	最大长度	描述
account	String	是	64	账号ID
roleId	String	是	64	角色ID
roleName	String	否	256	角色名称
serverId	String	否	256	服务器ID/名称
level	String	否	32	等级
recharge	Number	否	13	累计充值（单位分）

被举报人

参数	类型	必填	最大长度	描述
account	String	是	64	账号ID
roleId	String	是	64	角色ID
roleName	String	否	256	角色名称
serverId	String	否	256	服务器ID/名称
level	String	否	32	等级
recharge	Number	否	13	累计充值（单位分）

 

请求参数示例

{
    "businessId":"xxx966f73yyy59440583zzz9bfcc79df",
    "secretId":"nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp":${currentTime},
    "nonce":"mmm888f73yyy59440583zzz9bfcc79de",
    "version":"500",
    "signature":"lll888f73yyy59440583zzz9bfcc79da",
    "reportChannel":"举报渠道/入口",
    "reportTime":1680785420611,
    "whistleblower":"{\"account\":\"账号ID\",\"roleId\":\"角色ID\",\"roleName\":\"角色名称\",\"serverId\":\"服务器ID/名称\",\"level\":\"等级\",\"recharge\":10000000}",
    "reportedPerson":"{\"account\":\"账号ID\",\"roleId\":\"角色ID\",\"roleName\":\"角色名称\",\"serverId\":\"服务器ID/名称\",\"level\":\"等级\",\"recharge\":10000000}",
    "reportType":"举报类型 ",
    "reportScene":"举报场景/地点  ",
    "reportData":"举报内容详情"
}

响应

响应结果

响应数据格式为：JSON。

响应头为：Content-Type:application/json，具体如下：

参数	类型	描述
code	Integer	响应码，正常情况下为200，异常时，见 附录响应码定义
msg	String	响应码说明，正常情况下返回“ok”，异常时，见 附录响应码定义
data	JSONObject	返回数据

响应结果示例

• 举报数据上报正常时：

{
    "code": 200,
    "msg": "ok!",
    "data": {
  	}
}

响应返回码

响应返回码见：响应返回码

接入示例代码

服务端 SDK 接入

推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 服务端 SDK 接入指引了解更多。

Github Demo 地址

• Java SDK Demo
• Golang SDK Demo