숏클립 정보 조회

Prev Next

Live Station 의 숏클립 정보 조회를 위한 API입니다. 숏클립 정보 조회를 위해 숏클립 목록 조회를 위한 숏클립 목록 조회 API를 제공합니다.

요청

GET https://livestation.apigw.ntruss.com/api/fin-v2/channels/{channelId}/shortclip/{id}

요청 헤더

헤더명 필수 여부 설명
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 리전 코드 (FKR)

응답

필드명 타입 설명 비고
channelId String 숏클립 생성에 활용한 채널 ID
snapshotId Integer 숏클립 생성에 활용한 스냅샷 ID
shortclip Object 숏클립 오브젝트
shortclip.id Integer 숏클립 ID
shortclip.status String 숏클립 상태 CREATING,COMPLETED,PROCESSING_FAIL,UPLOAD_FAIL
shortclip.output Object 생성된 숏클립이 저장 될 정보
shortclip.output.accessControl String 생성된 숏클립이 저장 될 Object Storage Bucket 공개 범위를 지정하는 옵션
Default: PRIVATE		 PRIVATE,PUBLIC_READ
shortclip.output.bucketName String 생성된 숏클립이 저장 될 Object Storage 의 버킷명
shortclip.output.fileName String 생성된 숏클립의 파일명
shortclip.output.filePath String 생성된 숏클립이 저장 될 Object Storage 의 filePath
filePath 는 "/" 부터 시작 해야함
shortclip.createdTime Integer 생성된 숏클립 파일 생성 시간
shortclip.updatedTime Integer 생성된 숏클립 파일 업데이트 시간
shortclip.fileSize Integer 생성된 숏클립의 파일 사이즈
shortclip.duration Integer 생성된 숏클립의 재생 시간

예시

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Jun 2022 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "channelId": "ls-20220623115623-fHnXy",
    "snapshotId": 1047,
    "shortclip": {
      "id": 1060,
      "status": "CREATING",
      "createdTime": 1655979377666,
      "updatedTime": 1655979377666,
      "output": {
        "accessControl": "PRIVATE",
        "bucketName": "myTestBucket",
        "filePath": "/",
        "fileName": "1024-1655290646131.mp4"
      }
    }
  }
}