轮询模式
2024.10.15 18:18:14
直播音频账号名单轮询模式用于客户轮询调用该接口获取数据,得到直播账号最新状态。轮询模式与推送模式互斥,只能选取一种模式获取结果。
接口说明
该接口返回直播音频账号名单,需要客户通过该接口进行定时轮询获取,如需开启主动推送模式,可以联系易盾运营人员调整。轮询模式下,客户需要通过调用此接口获取直播音频账号名单。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持 MD5 加密算法,详细信息,请参见接口鉴权
结果说明
- 获取结果后,下次调用,不会再次返回之前获取过的结果
- 接口一次最多返回200个结果,审核结果数据默认保留7天,7天不获取会失效
- 接口请求频率建议1s一次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整
接口耗时
结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s
请求
请求地址
名称 | 描述值 |
---|---|
HTTP URL | http://as.dun.163.com/v4/liveAccountList/callback/results |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成
公共参数
公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数
业务参数
参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本v4 |
请求体示例
version=v4&signature=xxx&secretId=xxx&businessId=xxx
响应
响应结果
响应字段如下,响应公共字段已省略,详细见响应公共字段,result 详细字段信息如下:
参数名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
account | String | 是 | 主播账号,名单类型为禁言时返回的是声网/云信的uid |
type | Number | 是 | 名单类型 0-隐藏名单 1-禁播名单 2-重点关注名单 3-安全主播名单 4-禁言名单 5-房间禁播名单 9-房间隐藏名单 |
insertTime | Number | 是 | 名单入库时间 |
releaseTime | Number | 是 | 名单自动失效时间, 0代表不自动失效 |
spamType | Number | 是 | 违规类型 100-色情 200-广告 300-暴恐 400-违禁 500-涉政 800-不文明 1000-其他 |
spamLabel | Number | 否 | 违规分类标签: 隐藏名单分类标签——1-不符合运营需求 3-扰乱房间秩序 4-封面违规 5-即将违规 6-不优质 7-违规处罚 禁播名单分类标签——101-涉黄言论 102-低俗信息 103-垃圾广告 104-违禁内容 105-涉政内容 106-不文明行为 107-扰乱房间秩序 108-不符合平台运营要求 禁言名单分类标签——同禁播名单分类标签 重点关注名单分类标签——201-重点关注 安全主播名单分类标签——301-安全主播 |
spamDetail | String | 否 | 违规详情 |
status | Number | 是 | 名单状态 0-失效 1-生效 |
roomNo | String | 否 | 房间号 |
taskId | String | 否 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
actionTime | Number | 是 | 操作时间 |
transformAccount | String | 否 | 接入主播账号转换接口规范后返回的原主播账号 |
callback | String | 否 | 提交时传递的callback |
dimensionType | Number | 是 | 名单维度:主播名单-0,房间内用户名单-1,房间名单-2 |
响应示例
{
"code":0,
"msg":"ok",
"result":[
{
"account":"1810266547",
"type":5,
"insertTime":1631152969044,
"releaseTime":1631152969044,
"spamType":100,
"spamLabel":101,
"spamDetail":"223",
"status":1,
"taskId":"09090852193c4e9f88e731071a3a78ca",
"actionTime":0,
"transformAccount":"xx",
"callback":"",
"dimensionType":2
},
{
"account":"dasds",
"type":5,
"insertTime":1631152969044,
"releaseTime":1629820800000,
"spamType":100,
"spamLabel":101,
"spamDetail":"223",
"status":1,
"taskId":"1f9362152f7b4f42bd47aac870dd24c5",
"actionTime":0,
"dimensionType":2
}
]
}
响应返回码
响应返回码见:响应返回码