숏클립 목록 조회

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

숏클립 목록을 조회합니다. 생성 후 1시간 이내의 스냅샷에 대한 숏클립 목록만 조회할 수 있습니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /api/v2/channels/{channelId}/{snapshotId}/shortclips

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
channelId String Required 채널 아이디
snapshotId String Required 스냅샷 아이디

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
shortclipStatus String Optional 숏클립 상태로 필터링
  • CREATING | COMPLETED | PROCESSING_FAIL | UPLOAD_FAIL
    • CREATING: 생성 중
    • COMPLETED: 완료
    • PROCESSING_FAIL: 생성 실패
    • UPLOAD_FAIL: 업로드 실패

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/7559/shortclips' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Object - 응답 결과
content.channelId String - 채널 아이디
content.snapshotId Integer - 스냅샷 아이디
content.shortClipList Array - 숏클립 목록: shortClipList
total Integer - 전체 응답 수

shortClipList

shortClipList에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
id Integer - 숏클립 아이디
status String - 숏클립 상태
  • CREATING | COMPLETED | PROCESSING_FAIL | UPLOAD_FAIL
    • CREATING: 생성 중
    • COMPLETED: 완료
    • PROCESSING_FAIL: 생성 실패
    • UPLOAD_FAIL: 업로드 실패
createdTime Integer - 숏클립 생성 일시(밀리초)
  • Unix Timestamp 형식
updatedTime Integer - 숏클립 업데이트 일시(밀리초)
  • Unix Timestamp 형식
fileSize Integer - 숏클립 파일 크기(Byte)
duration Integer - 숏클립 재생 시간(밀리초)
output Object - 저장 정보
output.accessControl String - 숏클립 파일 저장 버킷 공개 범위
  • PRIVATE | PUBLIC_READ
    • PRIVATE: 비공개
    • PUBLIC_READ: 공개
output.bucketName String - 숏클립 파일 저장 버킷 이름
output.filePath String - 저장 상세 경로
output.fileName String - 숏클립 파일 이름

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "snapshotId": 7559,
        "shortClipList": [
            {
                "id": 1411,
                "status": "COMPLETED",
                "createdTime": 1755571698831,
                "updatedTime": 1755571699315,
                "fileSize": 1102425,
                "duration": 19916,
                "output": {
                    "accessControl": "PRIVATE",
                    "bucketName": "mybucket",
                    "filePath": "/shortclip",
                    "fileName": "1411-1755571698831.mp4"
                }
            },
            {
                "id": 1410,
                "status": "COMPLETED",
                "createdTime": 1755571641845,
                "updatedTime": 1755571642503,
                "fileSize": 561643,
                "duration": 10006,
                "output": {
                    "accessControl": "PRIVATE",
                    "bucketName": "mybucket",
                    "filePath": "/shortclip",
                    "fileName": "1410-1755571641845.mp4"
                }
            }
        ]
    },
    "total": 2
}