查询弹幕列表

接口描述

1、分页查询用户下所有的弹幕信息
2、接口URL中的{userid}为点播账号userid，具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议

接口URL

http://api.polyv.net/v2/danmu/{userid}

在线API调用

请求方式

GET

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

请求参数描述

示例

http://api.polyv.net/v2/danmu/1b448be323?vid=1b448be323b68b2999802799a98dba54_1&sign=F6254A68BF8AC6570848D86CDB7F57BB3989638A&numPerPage=1&ptime=1617241038467&pageNum=1

响应参数描述

data字段说明

contents字段说明

user参数描述

返回错误代码列表

Java请求示例

快速接入基础代码请下载相关依赖源码， 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 VodSignUtil.java 都包含在下载文件中。

强烈建议您使用点播Java SDK完成API的功能对接，点播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

 private static final Logger log = LoggerFactory.getLogger(VodVideoManagementTest.class);
 /**
  * 查询弹幕
  */
 @Test
 public void testGetDanmu() throws Exception, NoSuchAlgorithmException {
     //公共参数,填写自己的实际参数
     String secretKey = super.secretKey;
     String userId = super.userId;
     String ptime = String.valueOf(System.currentTimeMillis());
     //业务参数
     String url = String.format("http://api.polyv.net/v2/danmu/%s", userId);
     String vid =  "1b448be323b68b2999802799a98dba54_1";
     String numPerPage =  "1";
     String pageNum =  "1";

     Map<String, String> requestMap = new HashMap<>();
     requestMap.put("ptime", ptime);
     requestMap.put("vid", vid);
     requestMap.put("numPerPage", numPerPage);
     requestMap.put("pageNum", pageNum);
     requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));

     String response = HttpUtil.get(url, requestMap);
     log.debug("测试查询弹幕，{}", response);
     //do somethings
 }

响应示例

系统全局错误说明详见全局错误说明

成功示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "pageNumber": 1,
        "totalItems": 7,
        "contents": [{
            "id": 17252332,
            "vid": "1b448be323b68b2999802799a98dba54_1",
            "userid": "1b448be323",
            "msg": "测试获取弹幕信息",
            "time": "00:00:01",
            "fontsize": "24",
            "fontmode": "roll",
            "fontcolor": "0xFFFFFF",
            "timestamp": 1617176768000,
            "sessionid": null,
            "param2": null,
            "msgtype": "speak",
            "user": "",
            "origin": "vod",
            "viewerId": null
        }],
        "totalPages": 1,
        "endRow": 7,
        "startRow": 1,
        "nextPageNumber": 1,
        "prePageNumber": 1,
        "activePageNum": 1,
        "firstPage": true,
        "lastPage": true,
        "limit": 1,
        "offset": 0
    }
}

异常示例

 {
    "code": 400,
    "status": "error",
    "message": "ptime is too old.",
    "data": ""
}