7.방송 통계 조회

방송에 대한 통계 정보를 가져온다. 누적 시청자는 방송이 종료된 후에 조회 가능하며, interval을 사용하여 누적 시청자 추이 간격을 조절할 수 있다.

HTTP 요청

GET /api/2/applications/{app_key}/videos/{video_key}/stats

경로 변수

타입필수여부설명
app_keystringtrue애플리케이션의 키
video_keystringtrue비디오의 키

요청 파라미터

타입필수여부설명
intervalstringtrue누적 시청자 추이 간격(분). 기본값은 10

응답 본문

방송 통계 객체

타입설명
total_watcher_countlong누적 시청자 수
live_watcher_countlong라이브 시청자 수
max_watcher_countlong최대 시청자 수
total_message_countlong전체 채팅 메시지 개수
like_countlong좋아요 수
heart_countlong하트 수
avg_live_watch_timelong평균 시청 시간 (초)
total_watcher_trendArray누적 시청자 추이 객체 Array
vodObjectVOD 시청 통계. 기본 통계 객체
previewObjectPreview 시청 통계. 기본 통계 객체

기본 통계 객체

타입설명
view_countlong조회 수
avg_watch_countlong평균 시청 시간 (초)

누적 시청자 추이 객체

타입설명
timelong방송 시작 후 시간 (분)
total_watcher_countlong누적 시청자 수

요청 예

설명
GEThttps://api.flipflop.tv/api/2/applications/SAMPLE_APP/videos/100000/stats
HeaderAuthorization: Bearer {access_token}
Accept: application/json

응답 예

Http Status설명
200{"total_watcher_count": 0, "max_watcher_count":0, "total_message_count": 0, "avg_live_watch_time": 0, "like_count": 0, "total_watcher_trend":[], "vod":{"view_count": 0,"avg_watch_time": 0 }, "preview":{ "view_count": 0, "avg_watch_time": 0}
400{"code": 40000, "message": "Invalid user_id: valid value of 'user_id' is range 1 to 80."}