简要描述:
- 获取直播室或场次签到统计记录
请求URL:
- /zhibo/feedback/signs?sessionId={sessionId} 获取直播室某场次签到统计记录
- /zhibo/feedback/signs?roomId={roomId} 获取直播室所有签到统计记录
HTTP请求方法:
- GET
请求头:
NA
URL请求参数:
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
sessionId | String | 否 | 场次pid |
roomId | String | 否 | 房间pid,roomId和sessionId必须任意提供一个 |
limit | int | 否 | 每页记录数. 默认值为20. |
offset | int | 否 | 上一页最后一条记录号, offset必须是limit的倍数, 第一页为0. 当前页码可以通过offset/limit + 1来获得. 默认值为0. |
请求体参数:
NA
返回参数说明:
返回200的成功的响应体:
参数名 | 类型 | 说明 |
---|---|---|
datas[].pid | String | 发起签到pid |
datas[].sessionId | String | 直播场次pid |
datas[].hostId | String | 直播场次发起签到的主播人id |
datas[].notifyTime | String | 发起签到时间 |
datas[].notifyShortTime | String | 发起签到短时间HH:mm:ss |
datas[].notifyCount | long | 应签到总人数 |
datas[].feedbackCount | long | 签到总人数 |
datas[].sessionName | String | 直播场次名称 |
示例:
请求:
GET https://api-zhibo.yxt.com/v1/zhibo/feedback/signs?roomId=c4f0cb31-6b9f-44f0-86fc-00d231e436a5
Content-Type: application/json;charset=UTF-8
appkey: xxxxxxxxxxxxxxxxxxxxx
nonce: xxxx
timestamp: xxxxxxxxxx
signature: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
source: xxxx
请求体:
NA
正确时返回:
状态值: HTTP/1.1 200 OK.
Content-Type: application/json;charset=UTF-8
{
"datas": [
{
"pid": "404be109-3729-4e1a-92bc-8c86962e3570",
"sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
"hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
"notifyTime": "2017-02-15 14:25:18.0",
"notifyShortTime": "14:25:18",
"notifyCount": 100,
"feedbackCount": 1,
"sessionName": "直播场次"
},
{
"pid": "44e97593-a035-4b27-b504-7b89eed9de0b",
"sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
"hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
"notifyTime": "2017-02-15 14:23:45.0",
"notifyShortTime": "14:23:45",
"notifyCount": 100,
"feedbackCount": 1,
"sessionName": "直播场次"
},
{
"pid": "40e83099-665e-474a-8a7d-5ea1dbc979f3",
"sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
"hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
"notifyTime": "2017-02-15 14:23:13.0",
"notifyShortTime": "14:23:13",
"notifyCount": 100,
"feedbackCount": 0,
"sessionName": "直播场次"
}
]
}
错误时返回:
状态值: HTTP/1.1 400 Bad Request
{
"error": {
"key": "global.noprivilege",
"message": "No privilege."
}
}
错误代码列表:
格式: key=状态码;message
apis.auth.client.status.invalid=400;Client Org status is invalid.
apis.zhibo.orgadmin.validation.service.expired=400;Service is not active.
apis.zhibo.room.validation.notExisted=404;Room is not existed.
apis.zhibo.gift.precent.validation.provideRoomIdOrSessionId=400;need provide roomId or sessonId.