查询投诉反馈
更新时间:2023-05-11 14:31:52
接口描述
1、查询投诉反馈
2、支持https协议
接口URL
https://api.polyv.net/live/v4/channel/feedback/list
请求方式
GET
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | true | String | 账号appId【详见获取密钥】 |
| timestamp | true | Long | 当前13位毫秒级时间戳,3分钟内有效 |
| sign | true | String | 签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据【详见签名生成规则】 |
| channelId | false | String | 频道号,不传则查询用户下的数据 |
| pageNumber | false | Integer | 分页页码,默认1 |
| pageSize | false | Integer | 分页大小,默认10,最大不超过1000 |
示例
http://api.polyv.net/live/v4/channel/feedback/list?appId=frlr1zazn3&sign=EB9CF9CD3F473E0C6462E3031E97E7FA&channelId=1965681×tamp=1621843039780
响应参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 状态码,与 http 状态码相同,用于确定基本的响应状态 |
| status | String | 响应结果,由业务决定,成功返回success,失败返回error |
| success | Boolean | 是否成功响应 |
| requestId | String | 请求ID,每次请求生成的唯一的 UUID,仅可用于排查、调试,不应该和业务挂上钩 |
| error | Object | 状态码非200时的错误信息【详见error字段说明】 |
| data | Object | 投诉信息列表【详见data字段说明】 |
error字段说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误代码,用于确定具体的错误原因 |
| desc | String | 错误描述,与 error.code 对应 |
data字段说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| pageNumber | Integer | 当前页码 |
| pageSize | Integer | 每页数据量 |
| totalPages | Long | 页面总数 |
| totalItems | Long | 总数据量 |
| contents | Array | 当前页内容【详见contents字段说明】 |
contents字段说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | Integer | 投诉反馈ID |
| channelId | Integer | 频道号 |
| type | String | 投诉反馈类型 suggestion:反馈意见 complaint:投诉 |
| label | String | 所属分类 【详见label字段说明】 |
| content | String | 内容 |
| imageUrls | Array | 图片URL列表 |
| createTime | Long | 创建时间,13位毫秒级时间戳 |
| updateTime | Long | 更新时间,13位毫秒级时间戳 |
label字段值说明
| 值 | 含义 |
|---|---|
| stuck | 页面卡顿 |
| black-screen | 画面黑屏 |
| slow-access | 访问缓慢 |
| poor-experience | 体验不好 |
| play-suggestion | 玩法建议 |
| other-feedback | 其他反馈 |
| porn | 色情低俗 |
| politics | 涉政 |
| drug | 涉毒 |
| bloody | 恐怖血腥 |
| scam | 诈骗 |
| other-violations | 其他违规 |
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
/**
* 查询投诉反馈记录
* @throws IOException
*/
@Test
public void testGetFeedbackList() throws IOException, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String appId=super.appId;
String appSecret=super.appSecret;
String userId = super.userId;
String timestamp=String.valueOf(System.currentTimeMillis());
//业务参数
String url = "https://api.polyv.net/live/v4/channel/feedback/list";
String channelId = "1965681";
Integer pageNumber = 1;
Integer pageSize = 10;
//http 调用逻辑
Map<String,String> requestMap = new HashMap<>();
requestMap.put("appId", appId);
requestMap.put("timestamp",timestamp);
requestMap.put("channelId",channelId);
requestMap.put("pageNumber", String.valueOf(pageNumber));
requestMap.put("pageSize", String.valueOf(pageSize));
requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
String response = HttpUtil.get(url, requestMap);
}
响应示例
系统全局错误说明详见全局错误说明
成功示例
{
"code": 200,
"status": "success",
"requestId": "fe9b9752528b4a1c99fa25d361b0e36c.70.16609029221005237",
"data": {
"pageNumber": 1,
"pageSize": 10,
"totalPages": 1,
"totalItems": 2,
"contents": [
{
"id": 87,
"channelId": 1965681,
"type": "suggestion",
"label": "poor-experience",
"content": "123",
"imageUrls": [
"http://liveimages.videocc.net/watch-feedback/bbca707cc8/3221535/1659346624591_XWMPn9.jpeg",
"http://liveimages.videocc.net/watch-feedback/bbca707cc8/3221535/1659346624873_XSaKzQ.jpeg",
"http://liveimages.videocc.net/watch-feedback/bbca707cc8/3221535/1659346624890_31kGzs.jpeg"
],
"contact": "166",
"createTime": 1659346281000,
"updateTime": 1659346281000
},
{
"id": 88,
"channelId": 2880184,
"type": "suggestion",
"label": "poor-experience",
"content": "123",
"imageUrls": [
""
],
"contact": "166",
"createTime": 1659346465000,
"updateTime": 1659346465000
}
]
},
"success": true
}
异常示例
{
"code": 400,
"status": "error",
"message": "invalid signature.",
"data": ""
}
