举报数据上报接口

2024.04.24 13:16:29

    接口说明

    本接口用于上报应用的举报信息,需要客户申请智能风控服务,获取到产品密钥及业务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 地址

    Online Chat Tel:95163223 Free trial