轮询模式

2024.03.19 16:06:56

    直播音频账号名单轮询模式用于客户轮询调用该接口获取数据,得到直播账号最新状态。轮询模式与推送模式互斥,只能选取一种模式获取结果。

    接口说明

    该接口返回直播音频账号名单,需要客户通过该接口进行定时轮询获取,如需开启主动推送模式,可以联系易盾运营人员调整。轮询模式下,客户需要通过调用此接口获取直播音频账号名单。

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(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-房间禁播名单
    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
            }
        ]
    }
    

    响应返回码

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

    在线咨询 电话咨询:95163223 免费试用