工作室账号导出接口
2024.04.26 16:37:42
接口说明
提供当天之前的工作室账号检测数据导出。前一日的数据将在第二天凌晨8点后可以查询到,例如2024-01-01的数据在2024-01-02的早上8点之后可以查到。
鉴权说明
易盾智能风控服务使用签名认证方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5签名算法,详细信息请参见接口鉴权。
接入须知
- 导出数据量
- 采用深度分页方式返回数据:如果查询条件返回数据量超过1万条,会以分页形式返回;下一页查询标识,见
startFlag
请求参数说明
- 采用深度分页方式返回数据:如果查询条件返回数据量超过1万条,会以分页形式返回;下一页查询标识,见
- 查询频率限制
- 该接口返回数据量较大,不支持高并发查询,查询频率过快可能会被拒绝,拒绝后稍后重试即可
- 建议两次查询间隔为10s以上
请求说明
请求地址
名称 | 值 |
---|---|
HTTP URL | http://ir-open.dun.163.com/v5/studio/accountExport |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"Content-Type:application/json" |
请求参数
请求参数分为:公共参数,接口参数。其中,公共参数请见公共请求参数;接口参数如下:
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
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)、扩展账号、设备群控、轨迹群控团伙。 |
PS: 公共参数中的businessId只需传入该产品相应平台下任意的业务ID即可
请求参数示例
{
"businessId": "xxx966f73yyy59440583zzz9bfcc79df",
"secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
"timestamp": ${currentTimeMs},
"nonce": "mmm888f73yyy59440583zzz9bfcc79de",
"version": "500",
"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结构 |
参数 | 类型 | 说明 |
---|---|---|
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 | 渠道包名 |
riskTag | String | 风险标记 |
riskLevel | String | 风险等级 |
groupIdList | List<String> | 团伙ID列表 |
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 | 省份城市 |
riskTag | String | 风险标记 |
riskLevel | String | 风险等级 |
groupIdList | List<String> | 团伙ID列表 |
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",
"riskTag": "xxx",
"riskLevel": "中风险",
"groupIdList": ["xxx", "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",
"riskTag": "xxx",
"riskLevel": "中风险",
"groupIdList": ["xxx", "xxx"]
}
//... 此处省略9999条数据
]
},
"ok":true
}
响应返回码
响应返回码见:响应返回码