Stream Management

Create SMIL

post

This setting is available in the streaming(RTMP) resource type.

Path parameters

organization_uuidstringrequiredExample: ****-*****-****-****

resource_uuidstringrequiredExample: ****-*****-****-*****

Body

stream_namestring · min: 3 · max: 255requiredExample: streamsmil

smilsobject[]required

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "stream_name": "streamasmil",
  "smils": [
    {
      "smil_name": "smil",
      "qualities": [
        {
          "video_bitrate": 121321,
          "audio_bitrate": 12321312,
          "width": 123123,
          "height": 12312321
        }
      ]
    }
  ]
}

200

Stream and SMIL configuration created successfully

{
  "status": true,
  "data": {
    "stream_id": 54,
    "stream_name": "streamsmil",
    "stream_url": "rtmp://origin-l.glb.mncdn.com/test/streamsmil",
    "backup_url": "rtmp://origin-l-backup.glb.mncdn.com/test/streamsmil",
    "stream_hls_url": "https://OXmLWgYDSc.mncdn.com/test/streamsmil/index.m3u8",
    "smils": [
      {
        "smil_name": "smil",
        "qualities": [
          {
            "video_bitrate": 121321,
            "audio_bitrate": 12321312,
            "width": 123123,
            "height": 12312321
          }
        ],
        "smil_id": 63,
        "stream_name": null,
        "resource_uuid": null,
        "stream": null
      }
    ]
  }
}

Update Stream

put

Updates the details of a specific stream, including its associated SMIL configurations and qualities. This setting is available in the streaming(RTMP) resource type.

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

stream_idintegerrequired

ID of the stream to update

Body

stream_namestringoptionalExample: updatedStream

smilsobject[]optional

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 920

{
  "stream_name": "updatedStream",
  "smils": [
    {
      "smil_name": "updatedSmil",
      "stream_id": 54,
      "qualities": [
        {
          "video_bitrate": 150000,
          "audio_bitrate": 128000,
          "width": 1920,
          "height": 1080
        }
      ],
      "smil_id": 63,
      "stream_name": "updatedStreamName",
      "resource_uuid": "****-****-***-****",
      "stream": {
        "id": 55,
        "stream_name": "updatedStreamName",
        "resource_uuid": "****-****-***-****",
        "input_frame_rate": 60,
        "input_width": 1280,
        "input_height": 720,
        "audio_sample_rate": 44100,
        "audio_channels": "Stereo",
        "audio_bit_rate": 128,
        "outputs": [
          {
            "bitrate": 1000000,
            "picture_aspect_ratio": 16.9,
            "width": 1280,
            "height": 720
          }
        ],
        "profile": "Main",
        "level": 4,
        "key_frame": 4,
        "stream_url": "rtmp://origin-l.glb.mncdn.com/updatedStream/streamName",
        "backup_url": "rtmp://origin-l-backup.glb.mncdn.com/updatedStream/streamName",
        "created_at": "2024-12-29T18:00:00.000000Z",
        "updated_at": "2024-12-29T18:00:00.000000Z",
        "stream_hls_url": "https://example.mcdn.com/updatedStream/streamName/index.m3u8"
      }
    }
  ]
}

200

Stream updated successfully

{
  "status": true,
  "data": [
    {
      "id": 55,
      "stream_name": "updatedStreamName",
      "resource_uuid": "****-****-***-****",
      "input_frame_rate": 60,
      "input_width": 1280,
      "input_height": 720,
      "audio_sample_rate": 44100,
      "audio_channels": "Stereo",
      "audio_bit_rate": 128,
      "outputs": [
        {
          "bitrate": 1000000,
          "picture_aspect_ratio": 16.9,
          "width": 1280,
          "height": 720
        }
      ],
      "profile": "Main",
      "level": 4
    }
  ]
}

Delete Stream

delete

Deletes a specific stream identified by the stream ID. This setting is available in the streaming(RTMP) resource type.

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

stream_idintegerrequired

ID of the stream to delete

Responses

application/json

objectoptional

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

200

Stream deleted successfully

{
  "status": true,
  "data": true
}