Stop recording

This API ends recording of Live Station channel in progress.

Request

PUT https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/stopRecord

Request header

Response

Examples

Request example

PUT /api/v2/channels/ls-20200313162828-G60tN/stopRecord
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": {
      "27195": {
        "recordType": "MP4",
        "channelId": "ls-20210406135408-FNGOA",
        "status": "RECORDING",
        "recordSeq": 123175,
        "streamSeq": 138717,
        "recordBeginTime": 1621238888000,
        "createdTime": 1621238888000,
        "shouldDeleteTime": 1621843688000,
        "fileName": "138717-123175-202105171708.mp4",
        "uploadPath": "live-station/record/ls-20210406135408-FNGOA/138717-123175-202105171708.mp4",
        "objectStorageUrl": "-"
      },
      "27196": {
        "recordType": "HLS",
        "channelId": "ls-20210406135408-FNGOA",
        "status": "RECORDING",
        "recordSeq": 123175,
        "streamSeq": 138717,
        "recordBeginTime": 1621238888000,
        "createdTime": 1621238888000,
        "shouldDeleteTime": 1621843688000,
        "resolution": "0x0",
        "fileName": "bypass/playlist.m3u8",
        "videoBitrate": 299008,
        "audioBitrate": 128000,
        "videoFrameRate": 30,
        "audioCodec": "AAC",
        "uploadPath": "live-station/record/ls-20210406135408-FNGOA/bypass/123175",
        "objectStorageUrl": "-"
      }
    }
  },
  "total": 2
}

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.