Stream Management

Create SMIL

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

POSThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream

Path parameters

organization_uuid*string

Example: "****-*****-****-****"

resource_uuid*string

Example: "****-*****-****-*****"

Body

application/json

stream_name*string

Example: "streamsmil"

smils*array of object

Response

200

Stream and SMIL configuration created successfully

Body

application/json

status*boolean

Example: true

data*object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "stream_name": "streamasmil",
      "smils": [
        {
          "smil_name": "smil",
          "qualities": [
            {
              "video_bitrate": 121321,
              "audio_bitrate": 12321312,
              "width": 123123,
              "height": 12312321
            }
          ]
        }
      ]
    }),
});
const data = await response.json();

Response

200

{
  "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

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

stream_id*integer

ID of the stream to update

Body

application/json

The details of the stream and its SMIL configurations to update.

stream_namestring

Example: "updatedStream"

smilsarray of object

Response

200

Stream updated successfully

Body

application/json

statusboolean

Example: true

dataarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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"
          }
        }
      ]
    }),
});
const data = await response.json();

Response

200

{
  "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

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

DELETEhttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

stream_id*integer

ID of the stream to delete

Response

200

Stream deleted successfully

Body

application/json

statusboolean

Example: true

databoolean

Example: true

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

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