스케줄 생성
    • PDF

    스케줄 생성

    • PDF

    기사 요약

    Live Station 의 VOD 스케줄을 생성하는 API 입니다. 생성한 스케줄 정보 조회를 위해 스케줄 정보 조회 API를 제공합니다.

    VOD 스케줄
    • 스케줄 생성을 통해 Object Storage 에 업로드된 영상(mp4) 을 정해진 시간(startTime) 에 맞춰 라이브로 송출 할 수 있습니다.
    • 최대 50개 영상 재생을 지원 하며, 상세 사항은 아래 내용을 참고 부탁 드립니다.
    VOD 스케줄 생성시 유의 사항
    • 스케줄 생성은 VOD 채널 상태가 READY 일때 가능합니다.
    • 채널에 이미 예약된 스케줄이 있으면 추가 스케줄을 생성할 수 없습니다.
    • 예약된 스케줄의 방송이 종료되거나 방송 대기중인 스케줄을 삭제한 이후에 다시 스케줄을 등록할 수 있습니다.
    • 스케줄 시작 시간 (startTime) 은 KST(UTC+9) 기준으로 요청 합니다.

    요청

    POST https://livestation.apigw.ntruss.com/api/fin-v2/vod/schedule
    

    요청 헤더

    헤더명필수 여부설명
    x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeYESRequest body content type을 application/json으로 지정
    Content-Type: application/json
    x-ncp-region_codeYES리전 코드 (FKR)

    요청 바디

    필드명필수 여부타입제약 사항설명
    channelIdYesString스케줄을 송출 할 VOD Channel 의 channelId스케줄을 실행 할 채널로 이미 스케줄이 등록된 채널은 사용 불가
    startTimeYesInteger요청 시간 보다 과거 시간 입력 불가
    최소 입력 시간 : 현재 요청 시점 + 10분 이후 시간
    최대 입력 시간 : 현재 요청 시점 + 14일
    입력한 VOD 를 송출 할 시작 시간
    시작 시간 포맷 : yyyymmddhhss
    KST(UTC+9) 기준
    vodListYesArraymp4 확장자만 지원 가능
    최대 50개 영상 입력 가능
    vodList.bucketNameYesString송출 할 영상이 저장된 Object Storage 의 버킷명
    vodList.filePathYesString송출 할 영상이 저장된 Object Storage 의 filePath
    filePath 는 "/" 부터 시작 해야함

    응답

    필드명타입설명비고
    scheduleIdInteger
    channelIdString
    createdTimeTimestampepoch time
    startTimeTimestampepoch time
    updatedTimeTimestamp
    statusStringCREATING,PROCESSING,PROCESSING_FAIL,UPDATING,READY,FINISH,DELETED
    vodListArray

    예시

    요청 예시

    POST /api/fin-v2/vod/schedule
    HOST: livestation.apigw.ntruss.com
    Content-Type: application/json
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
    x-ncp-region_code:KR
    
    Request body  
    {
      "channelId": "ls-20211122220557-mUv3r",
      "startTime": "20211124002500",
      "vodList": [
        {
          "bucketName": "myBucket",
          "filePath": "/myFile.mp4"
        },
        {
          "bucketName": "myBucket2",
          "filePath": "/mp4/myFile2.mp4"
        },
        {
          "bucketName": "myBucket2,
          "filePath": "/mp4/myFile3.mp4"
        }
      ]
    }
    

    응답 예시

    HTTP/1.1 200 OK
    Server: nginx
    Date: Fri, 26 Feb 2021 09:53:32 GMT
    Content-Type: application/json;charset=utf-8
    Connection: keep-alive
    Access-Control-Allow-Origin: *
    x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
    
    {
      "content": {
        "scheduleId": 10053,
        "channelId": "ls-20211122220557-mUv3r",
        "createdTime": 1637679144884,
        "startTime": 1637681100000,
        "updatedTime": 1637679144884,
        "status": "CREATING",
        "vodList": [
          "/myBucket/myFile.mp4",
          "/myBucket2/mp4/myFile2.mp4",
          "/myBucket2/mp4/myFile3.mp4"
        ]
      }
    }
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.