反外挂角色ID存在验证

2024.06.20 14:37:11

    接口用途

    本接口用于验证角色ID,是否存在嫌疑上报数据中。支持批量验证。

    接入须知

    注意事项:因取证信息场景复杂,为了保障封号依据完备,如需封号,建议结合角色的业务数据进行二次判断或者 和易盾技术人员进行二次确认,以确保准确无误 ;控制接口调用频率,频率过高,可能会超过频率限制,导致查询失败,建议间隔10s。

    使用形式

    • 接口地址:http://open-yb.dun.163.com/api/open/v1/risk/doubtful/checkroleidexist

    • 请求方法:POST

    • 请求头:Content-Type:application/json

    请求参数

    • 请求参数:包括公共参数和接口参数
    名称 类型 是否必填 描述
    beginTime Long 开始时间,单位毫秒
    endTime Long 结束时间,单位毫秒
    roleIds Array<String> 数组最大个数:100

    请求参数示例(包括公共参数)

    {
       "appId": "xxx8888894",
        "timestamp": ${currentTime},
        "nonce":111,
        "token": "${sign}",
        "roleIds":  ["roleTestid","roleTestid2","TransTest"],
        "beginTime":1575388800000,
        "endTime": 1585545601000
    }
    
    

    响应结果

    • 响应数据格式:JSON
      • 响应头为:Content-Type: application/json
    参数名称 类型 描述
    code Integer 响应码,正常情况时为200,异常时,见响应返回码
    msg String 响应码说明,正常时返回ok,异常时,见响应返回码
    data RoleInfo 返回数据,格式见【RoleInfo数据格式】
    lastestEventTime Long 不为默认值0时,表示可供查询数据的最新时间
    • RoleInfo数据格式:
    名称 类型 描述
    total Integer 返回记录条数,去重
    roleIds Array<String> 记录明细

    响应结果示例

    • 存在角色ID时:

      {
        "code": 0,
         "msg": null,
         "data": {
            "total": 2,
            "roleIds": [
                "TransTest",
                "roleTestid"
            ]
        },
        "lastestEventTime": 0
      }
      
    • 当不存在角色ID时:

      {
      
        "code": 0,
        "msg":"当前查询条件无数据返回,可能因为数据不存在或者数据处理未完成,可供查询数据的最新时间见lastestEventTime字段。",
        "data": {
            "total": 0,
            "roleIds": []
        },
       "lastestEventTime": 1578366604897
      }
      

    注意:

    • 当返回无数据时,数据处理可能存在延时或者数据不存在。
    • 当设置查询的结束时间endTime小于lastestEventTime时,如果返回无数据,则确认是数据不存在。
    • 自动封禁有风险,操作请谨慎,建议综合参考其它因素。
    Online Chat Tel:95163223 Free trial