스케줄 생성
- 인쇄
- PDF
스케줄 생성
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Live Station 의 VOD 스케줄을 생성하는 API 입니다. 생성한 스케줄 정보 조회를 위해 스케줄 정보 조회 API를 제공합니다.
참고
- 스케줄 생성을 통해 Object Storage 에 업로드된 영상(mp4)을 정해진 시간(startTime) 에 맞춰 라이브로 송출 할 수 있습니다.
- 최대 50개 영상 재생을 지원하며, 상세 사항은 아래 내용을 참고해 주십시오.
주의
VOD 스케줄 생성시 유의 사항은 다음과 같습니다.
- 스케줄 생성은 VOD 채널 상태가 READY 일때 가능합니다.
- 채널에 이미 예약된 스케줄이 있으면 추가 스케줄을 생성할 수 없습니다.
- 예약된 스케줄의 방송이 종료되거나 방송 대기중인 스케줄을 삭제한 이후에 다시 스케줄을 등록할 수 있습니다.
- 스케줄 시작 시간 (startTime) 은 KST(UTC+9) 기준으로 요청 합니다.
요청
POST https://livestation.apigw.ntruss.com/api/v2/vod/schedule
요청 헤더
| 헤더명 | 필수 여부 | 설명 |
|---|---|---|
| x-ncp-apigw-timestamp | YES | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | YES | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | YES | Request body content type을 application/json으로 지정Content-Type: application/json |
| x-ncp-region_code | YES | 리전 코드 (KR) |
요청 바디
| 필드명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| channelId | Yes | String | 스케줄을 송출 할 VOD Channel 의 channelId | 스케줄을 실행 할 채널로 이미 스케줄이 등록된 채널은 사용 불가 |
| startTime | Yes | Integer | 요청 시간 보다 과거 시간 입력 불가 최소 입력 시간 : 현재 요청 시점 + 10분 이후 시간 최대 입력 시간 : 현재 요청 시점 + 14일 | 입력한 VOD 를 송출 할 시작 시간 시작 시간 포맷 : yyyyMMddHHmmss KST(UTC+9) 기준 |
| vodList | Yes | Array | mp4 확장자만 지원 가능 최대 50개 영상 입력 가능 | |
| vodList.bucketName | Yes | String | 송출 할 영상이 저장된 Object Storage 의 버킷명 | |
| vodList.filePath | Yes | String | 송출 할 영상이 저장된 Object Storage 의 filePath filePath 는 "/" 부터 시작 해야함 |
응답
| 필드명 | 타입 | 설명 | 비고 |
|---|---|---|---|
| scheduleId | Integer | ||
| channelId | String | ||
| createdTime | Timestamp | String | epoch time |
| startTime | Timestamp | epoch time | |
| updatedTime | Timestamp | ||
| status | String | CREATING,PROCESSING,PROCESSING_FAIL,UPDATING,READY,FINISH,DELETED | |
| vodList | Array |
예시
요청 예시
POST /api/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"
]
}
}
이 문서가 도움이 되었습니까?