简要描述:

  • 获取直播室或场次签到统计记录

请求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

  1. {
  2. "datas": [
  3. {
  4. "pid": "404be109-3729-4e1a-92bc-8c86962e3570",
  5. "sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
  6. "hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
  7. "notifyTime": "2017-02-15 14:25:18.0",
  8. "notifyShortTime": "14:25:18",
  9. "notifyCount": 100,
  10. "feedbackCount": 1,
  11. "sessionName": "直播场次"
  12. },
  13. {
  14. "pid": "44e97593-a035-4b27-b504-7b89eed9de0b",
  15. "sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
  16. "hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
  17. "notifyTime": "2017-02-15 14:23:45.0",
  18. "notifyShortTime": "14:23:45",
  19. "notifyCount": 100,
  20. "feedbackCount": 1,
  21. "sessionName": "直播场次"
  22. },
  23. {
  24. "pid": "40e83099-665e-474a-8a7d-5ea1dbc979f3",
  25. "sessionId": "bff65532-03e4-467b-b8bd-3bab04730692",
  26. "hostId": "c1993df0-1ed6-44bd-af50-6e930eb98a70",
  27. "notifyTime": "2017-02-15 14:23:13.0",
  28. "notifyShortTime": "14:23:13",
  29. "notifyCount": 100,
  30. "feedbackCount": 0,
  31. "sessionName": "直播场次"
  32. }
  33. ]
  34. }

错误时返回:

状态值: HTTP/1.1 400 Bad Request

  1. {
  2. "error": {
  3. "key": "global.noprivilege",
  4. "message": "No privilege."
  5. }
  6. }

错误代码列表:

格式: 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.