图像外挂查询接口

2024.06.20 14:06:52

    接口说明

    本接口用于查询图像外挂识别接口的检测结果。

    鉴权说明

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

    接入须知

    因取证信息场景复杂,为了保障封禁动作依据完备,如需封号,建议结合用户/玩家的业务数据进行二次判断,或者与易盾技术人员进行二次确认,以确保准确无误。请控制接口调用频率,频率过高,可能会超过频率限制,导致查询失败,建议QPS不超过1。

    请求说明

    请求地址

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

    请求头

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

     

    请求参数

    请求参数分为:公共参数,接口参数。其中,公共参数请见公共请求参数;接口参数如下:

    参数 类型 必填 描述
    taskId String 检测任务 ID

     

    请求参数示例

    {
        "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
        "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
        "timestamp": ${currentTime},
        "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
        "version": "500",
        "signature": "lll888f73yyy59440583zzz9bfcc79da",
        "taskId":  "e6ewxylcm62kh1a7yra3hxdgdd00a7p4"
    }
    

    响应

    响应结果

    响应数据格式为:JSON。

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

    参数 类型 描述
    code Integer 响应码,正常情况下为200,异常时,见 附录响应码定义
    msg String 响应码说明,正常情况下返回“ok”,异常时,见 附录响应码定义
    desc String 响应信息描述,非必返,常见错误情况下会返回错误说明或错误参考文档
    data JSONObject 返回数据,格式下表说明

    返回数据的格式:

    参数 类型 说明
    receiveTime Long 请求收到时间
    ip String 用户/玩家的IP
    roleId String 用户/玩家的角色ID
    nickname String 用户/玩家的昵称
    server String 用户/玩家的角色的服务器名称
    status Integer 检测状态:-1:未检测, 0:正常, 1:异常
    tagNameList List 命中标签名称列表
    reason String 详情

    响应结果示例

    • 识别结果正常时:
    {
        "code": 200,
        "msg": "成功",
        "data": 
            {
                "receiveTime": 1715531484738,
                "ip": "1.1.1.1",
                "roleId": "mediaRoleId01",
                "nickname": "mediaNickName01",
                "server": "mediaServer01",
                "status": 1,
                "tagNameList": ["外挂嫌疑","外挂软件"],
                "reason": "reason01"
            },
            "ok": true
    }
    

    注意事项

    • 当查询频率过高返回超出限流时,可稍后再次重试。
    • 当返回无数据时,可能原因包括数据不存在,或数据超过当前默认一个月的留存周期。
    • 自动封禁有风险,操作请谨慎,建议参考其他因素综合考虑。

    响应返回码

    响应返回码见:响应返回码

    Online Chat Tel:95163223 Free trial