MENU
      View short-clip list

        View short-clip list


        Article summary

        An API to view short-clip list of Live Station. Provides the short-clip information view API to view short-clip list to view information on short-clips.

        Requests

        GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/{snapshotId}/shortclips?shortclips?shortclipStatus={shortclipStatus}
        HTTP

        Request parameters

        Parameter nameRequiredTypeService limitsDescription
        shortclipStatusNoStringCREATING,COMPLETED,PROCESSING_FAIL,UPLOAD_FAILStatus of short-clip to be viewed

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYESTime elapsed since January 1, 1970 00:00:00 UTC in milliseconds. The request is considered invalid if the time difference compared to the API Gateway server is 5 minutes or longer
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESAccess key ID value issued from NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecifies the request body content type as application/json
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Responses

        Field nameTypeDescriptionNote
        channelIdStringChannel ID used in creating short-clip
        snapshotIdIntegerSnapshot ID used in creating short-clip
        shortclipListArrayList of created short-clips
        shortclipList.idIntegerShort-clip ID
        shortclipList.statusStringShort-clip statusCREATING,COMPLETED,PROCESSING_FAIL,UPLOAD_FAIL
        shortclipList.outputObjectInformation in which the created short-clip is to be stored
        shortclipList.output.accessControlStringOption which specifies the scope of disclosure of the Object Storage Bucket in which the created short-clip is to be stored
        Default: PRIVATE
        PRIVATE,PUBLIC_READ
        shortclipList.output.bucketNameStringBucket name of the Object Storage in which the created short-clip is to be stored
        shortclipList.output.filePathStringfilePath of the Object Storage in which the created short-clip is to be stored
        filePaths must start with "/"
        shortclipList.output.fileNameStringFile name of the created short-clip
        shortclipList.createdTimeIntegerTime of creation of the created short-clip file
        shortclipList.updatedTimeIntegerUpdate time of the created short-clip file
        shortclipList.fileSizeIntegerFile size of the created short-clip
        shortclipList.durationIntegerPlayback time of the created short-clip

        Examples

        Response examples

        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-20220610140221-hA6v8",
            "snapshotId": 1013,
            "shortClipList": [
              {
                "id": 1024,
                "status": "COMPLETED",
                "createdTime": 1655290646131,
                "updatedTime": 1655290650233,
                "fileSize": 12699676,
                "duration": 101184,
                "output": {
                  "accessControl": "PRIVATE",
                  "bucketName": "myTestBucket",
                  "filePath": "/",
                  "fileName": "1024-1655290646131.mp4"
                }
              },
              {
                "id": 1023,
                "status": "COMPLETED",
                "createdTime": 1655290258224,
                "updatedTime": 1655290262577,
                "fileSize": 62607,
                "duration": 1195,
                "output": {
                  "accessControl": "PRIVATE",
                  "bucketName": "myTestBucket",
                  "filePath": "/",
                  "fileName": "1023-1655290258224.mp4"
                }
              }
            ]
          },
          "total": 2
        }
        HTTP

        Was this article helpful?

        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.