Powered by Algolia
    FlipFlop SDK
    Doc

    9.예약 방송 생성하기

    예약 방송을 위해 방송 정보를 미리 생성해 둔다. 이미 종료한 라이브 방송이 있다면 4.방송 송출 시작 API를 이용하여 재송출을 할 수 있다.

    HTTP 요청

    POST    /api/2/applications/{app_key}/reservations

    경로 변수

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

    요청 본문

    키타입필수여부설명
    titlestringtrue방송 제목
    user_idstringtrue방송할 사용자의 ID
    source_video_keystringfalse재방송으로 송출하려는 비디오 키

    응답 본문

    방송 객체

    키타입설명
    video_keystring방송 키
    statestring방송 상태. LIVE 또는 VOD
    urlstring방송 URL
    thumbnail_urlstring방송 썸네일 URL
    durationlong방송 길이(millisecond)
    watch_countlongLIVE 시청자 수
    heart_countlong하트 수
    view_countlong조회 수
    like_countlong좋아요 수
    video_download_urllong(방송 종료시 포함) 비디오 파일
    chat_download_urlstring(방송 종료시 포함) 채팅 메시지 파일
    preview_urlstring하이라이트 URL
    preview_durationlong하이라이트 길이(millisecond)
    started_atlong방송 시간 시간 (unix timestamp, millisecond)
    ended_atlong방송 종료 시간 (unix timestamp, millisecond)
    recorded_atlong녹화 시작 시간 (unix timestamp, millisecond)
    statsobject(방송 종료시 포함) 방송 통계 객체

    요청 예

    키설명
    GEThttps://api.flipflop.tv/api/2/applications/SAMPLE_APP/reservations
    HeaderAuthorization: Bearer {access_token}
    Accept: application/json
    Payload{"title": "방송 예약", "user_id":"sample_user_id"}

    응답 예

    Http Status설명
    200{"video_key": "10000", "url": "{broadcast_host_url}/10000/index.m3u8", "thumbnail_url": "{thumbnail_host_url}/videos/10000/thumbnail.jpg?time=1619480079775", "state": "CREATED" }}
    400{"code": 40000, "message": "Invalid user_id: valid value of 'user_id' is range 1 to 80."}