방송 정보를 조회한다. 콜백에 포함 되어 있는 방송 정보랑 동일한 객체를 사용한다. 콜백을 못받을 경우 이 API를 이용해서 동일한 결과를 조회할 수 있다.
HTTP 요청
GET /api/2/applications/{app_key}/videos/{video_key}
경로 변수
| 키 | 타입 | 필수여부 | 설명 |
|---|
| app_key | string | true | 애플리케이션의 키 |
| video_key | string | true | 비디오의 키 |
요청 파라미터
| 키 | 타입 | 필수여부 | 설명 |
|---|
| type | string | true | 비디오 객체 버전. 1을 사용 |
응답 본문
방송 객체
| 키 | 타입 | 설명 |
|---|
| video_key | string | 방송 키 |
| state | string | 방송 상태. LIVE 또는 VOD |
| url | string | 방송 URL |
| thumbnail_url | string | 방송 썸네일 URL |
| duration | long | 방송 길이(millisecond) |
| watch_count | long | LIVE 시청자 수 |
| heart_count | long | 하트 수 |
| view_count | long | 조회 수 |
| like_count | long | 좋아요 수 |
| video_download_url | long | (방송 종료시 포함) 비디오 파일 |
| chat_download_url | string | (방송 종료시 포함) 채팅 메시지 파일 |
| preview_url | string | 하이라이트 URL |
| preview_duration | long | 하이라이트 길이(millisecond) |
| started_at | long | 방송 시간 시간 (unix timestamp, millisecond) |
| ended_at | long | 방송 종료 시간 (unix timestamp, millisecond) |
| recorded_at | long | 녹화 시작 시간 (unix timestamp, millisecond) |
| stats | object | (방송 종료시 포함) 방송 통계 객체 |
요청 예
응답 예
| Http Status | 설명 |
|---|
| 200 | {"video_key": "a10000", "url": "{broadcast_host_url}/10000/index.m3u8", "thumbnail_url": "{thumbnail_host_url}/videos/10000/thumbnail.jpg?time=1619480079775", "state": "LIVE" }} |
| 400 | {"code": 40000, "message": "Invalid user_id: valid value of 'user_id' is range 1 to 80."} |