Get recording list

This API gets the list of VOD generated by Live Station channel.

Request

GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/records

Request header

Response

Examples

Request example

GET /api/v2/channels/ls-20200313162828-G60tN/records
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

Response example

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

{ 
   "content" : {
       "recordList": {
            "298": {
                "recordType" : "MP4",
                "channelId" : "ls-20200313162828-G60tN",
                "status" : "TRANSFER_READY",
                "recordSeq" : 104077,
                "streamSeq" : 137305,
                "recordBeginTime" : 1584952615000,
                "createdTime" : 1584955616000,
                "shouldDeleteTime" : 1585560416000,
                "resolution" : "480x270",
                "fileName" : "137305-104077-202003231736.mp4",
                "duration" : 2996437,
                "videoBitrate" : 400000,
                "audioBitrate" : 64000,
                "videoFrameRate" : 15.0,
                "audioCodec" : "aac",
                "uploadPath" : "live-station/record/ls-20200313162828-G60tN/137305-104077-202003231736.mp4",
                "objectStorageUrl":"-"
            },
            "299": {
                "recordType" : "HLS",
                "channelId" : "ls-20200313162828-G60tN",
                "status" : "TRANSFER_READY",
                "recordSeq" : 104077,
                "streamSeq" : 137305,
                "recordBeginTime" : 1584952615000,
                "createdTime" : 1584955616000,
                "shouldDeleteTime" : 1585560416000,
                "resolution" : "480x270",
                "fileName" : "270p-16-9/playlist.m3u8",
                "videoBitrate" : 400000,
                "audioBitrate" : 64000,
                "videoFrameRate" : 15.0,
                "uploadPath" : "live-station/record/ls-20200313162828-G60tN/270p-16-9/104077",
                "objectStorageUrl":"-"
            }
       }
    },
   "total" : 6
}

Error codes

If the Live Station API request is invalid or if an error occurs during processing, it returns a success/failure to HTTP status code and returns a detailed message in JSON format.

There are two error codes: 'Common error codes' and 'API Gateway error codes' in the Live Station API.