接口说明

提供当天之前的工作室账号检测数据导出。前一日的数据将在第二天凌晨8点后可以查询到，例如2024-01-01的数据在2024-01-02的早上8点之后可以查到。当前接口版本为V5，version: 501，历史子版本参考500，更新日志参考接口更新日志。

鉴权说明

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

接入须知

• 导出数据量
  • 采用深度分页方式返回数据：如果查询条件返回数据量超过1万条，会以分页形式返回；下一页查询标识，见startFlag请求参数说明
• 查询频率限制
  • 该接口返回数据量较大，不支持高并发查询，查询频率过快可能会被拒绝，拒绝后稍后重试即可
  • 建议两次查询间隔为10s以上

 

请求说明

请求地址

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

请求头

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

 

请求参数

部分产品相关参数请用账号登陆易盾官网控制台获取参考

请求参数包括：公共参数和私有参数。其中，公共参数如下：

参数	类型	必填	参与签名计算	最小长度	最大长度	描述
businessId	String	是	是	10	32	每个业务接入时，会分配唯一的业务 ID。
secretId	String	是	是	32	36	产品密钥，每个应用接入时，会分配secretId和私钥secretKey。
timestamp	Long	是	是	13	13	接口调用时的UNIX时间戳，单位：毫秒，用于判断请求是否过期
nonce	String	是	是	32	32	随机码，用于防止重放，固定长度32个字符，不能重复，建议使用UUID
version	String	是	是	3	3	当前页面接口版本号：501
signature	String	是	否	32	32	使用 secretKey 生成的签名，用于身份验证，生成方法见接口鉴权

ps: 公共参数中的businessId只需传入该产品相应平台下任意的业务ID即可

私有参数如下：

参数	类型	必填	描述
date	String	是	查询日期，yyyy-MM-dd形式例：2022-01-12
startFlag	String	否	用于分页查询的关联标记。第一次查询时，该字段填充空字符串""或不传该字段均可，后续查询时，需要判断上一次查询的返回数据中startFlag值，如果startFlag不为空字符串""，表示需要分页查询。当使用分页查询时，startFlag字段使用上一次返回值填充，其他字段保持不变，继续调用查询接口。如果startFlag为空字符串""，例如返回数据为{"code": 200, "msg": "ok", "data": {"size": 100, "startFlag": "", "detail": [{},...]}}，表示不需要分页查询，可以使用新的时间条件查询。
groupId	String	否	工作室团伙ID
riskLevel	Integer	否	工作室风险等级，0-低风险，1-中风险，2-高风险
riskTagList	List<String>	否	工作室风险标签，枚举如下：多开(Server) 、高频改机、多开(Client)、多开聚合(Server)、深度聚合(Server)、多开聚合(Client)、深度聚合(Client)、扩展账号、设备群控、轨迹群控团伙。
categoryList	List<String>	否	风险类别。

PS: 公共参数中的businessId只需传入该产品相应平台下任意的业务ID即可

请求参数示例

{
        "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
        "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
        "timestamp": ${currentTimeMs},
        "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
        "version": "501",
        "signature": "lll888f73yyy59440583zzz9bfcc79da",
        "date": "2022-01-12"
        "startFlag": ""
        }

响应

响应结果

响应数据格式为：JSON。

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

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

数据格式：

参数	类型	说明
size	Integer	本次查询返回的数据条数
startFlag	String	用于分批查询的关联标记。1. 当查询需要分批返回数据时，表示下一批数据起始标记。2. 当该值返回为空字符串""时，表示数据都已经返回，不需要继续执行下一批查询
detail	Array<DetailData>	具体返回数据，每条数据类型见明细数据DetailData结构

明细数据DetailData结构

参数	类型	说明
groupClusterId	String	团伙簇ID
groupRoleCnt	Long	团伙角色数量
deviceClusterId	String	设备簇ID
deviceRoleCnt	Long	设备角色数量
account	String	账号
roleId	String	角色id
nickname	String	昵称
deviceId	String	设备id
server	String	服务器名称
ip	String	ip地址
provinceCity	String	省份城市
packageName	String	渠道包名
category	String	风险标记分类
riskTag	String	风险标记
riskLevel	String	风险等级
groupIdList	List<String>	团伙ID列表
riskClue	String	文本线索
riskClueImg	List<String>	图片线索
riskClueAsr	List<String>	音频asr线索
riskClueGraphUrl	String	关联网络图
Web端 明细数据DetailData结构

参数	类型	说明
groupClusterId	String	团伙簇ID
groupRoleCnt	Long	团伙角色数量
deviceClusterId	String	设备簇ID
deviceRoleCnt	Long	设备角色数量
account	String	账号
roleId	String	角色id
nickname	String	昵称
deviceId	String	设备id
server	String	服务器名称
ip	String	ip地址
provinceCity	String	省份城市
category	String	风险标记分类
riskTag	String	风险标记
riskLevel	String	风险等级
abnormalTimes	List<Long>	异常开始时间
groupIdList	List<String>	团伙ID列表
riskClue	String	文本线索
riskClueImg	List<String>	图片线索
riskClueAsr	List<String>	音频asr线索
riskClueGraphUrl	String	关联网络图
runEnvType	Integer	运行环境:1：Mobile Web 2：Desktop Web 3：未知
browserName	String	浏览器名称
kernelName	String	浏览器内核

响应结果示例

• 当不需要执行下一批次查询时：

{
        "code": 200,
        "msg": "ok!",
        "data": {
        "size": 100,
        "startFlag": "",
        "detail": [
        {
        "groupClusterId": "xxx",
        "groupRoleCnt": 10,
        "deviceClusterId": "xxxx",
        "deviceRoleCnt": 9,
        "account": "xxx",
        "roleId": "xxx",
        "nickname": "xxx",
        "deviceId": "xxx",
        "server": "xxx",
        "ip": "127.0.0.1",
        "provinceCity": "xxx",
        "packageName": "xxx",
        "category": "xxx",
        "riskTag": "xxx",
        "riskLevel": "中风险",
        "groupIdList": ["xxx", "xxx"],
        "riskClue": "xxx",
        "riskClueImg": ["xxx", "xxx"],
        "riskClueAsr":["xxx", "xxx"],
        "riskClueGraphUrl": "xxx",
        }
        //... 此处省略99条数据
        ]
        },
        "ok":true
        }

• 当需要继续执行下一批次查询时：

{
        "code": 200,
        "msg": "ok!",
        "data": {
        "size": 10000,
        "startFlag": "vafal4asf5db2s1gfgdfjnsn12dmv5",
        "detail": [
        {
        "groupClusterId": "xxx",
        "groupRoleCnt": 10,
        "deviceClusterId": "xxxx",
        "deviceRoleCnt": 9,
        "account": "xxx",
        "roleId": "xxx",
        "nickname": "xxx",
        "deviceId": "xxx",
        "server": "xxx",
        "ip": "127.0.0.1",
        "provinceCity": "xxx",
        "packageName": "xxx",
        "category": "xxx",
        "riskTag": "xxx",
        "riskLevel": "中风险",
        "groupIdList": ["xxx", "xxx"],
        "riskClue": "xxx",
        "riskClueImg": ["xxx", "xxx"],
        "riskClueAsr": ["xxx", "xxx"],
        "riskClueGraphUrl": "xxx"
        }
        //... 此处省略9999条数据
        ]
        },
        "ok":true
        }

响应返回码

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