Resources

PreviousPerformance / CDN NextOrigin Settings

Last updated 9 days ago

Was this helpful?

Create Small and Large Resource

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

resource_namestringrequired

The name of the resource

resource_labelstring

Label for the resource

data_sourcestring · enumrequired

The source of the data

Options: origin

resource_typestring · enumrequired

The type of the resource

Options: small, large

origin_typestring · enumrequired

The type of the origin

Options: mainstream

origin_settingsobject[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "large-openapilarge",
    "resource_label": "",
    "data_source": "origin",
    "resource_type": "large",
    "origin_type": "mainstream",
    "origin_settings": [
      {
        "protocol": "https",
        "origin_url": "large.com",
        "host_header": "host.com",
        "http_port": 80,
        "https_port": 443,
        "is_delete": false,
        "status_origin_s3_presign": false,
        "weight": 50,
        "priority": "standby"
      },
      {
        "protocol": "http",
        "origin_url": "large2.com",
        "host_header": "hostx.com",
        "http_port": 80,
        "https_port": 443,
        "is_delete": false,
        "status_origin_s3_presign": false,
        "weight": 50,
        "priority": "primary"
      }
    ]
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*****",
    "resource_type": "small",
    "resource_name": "test-openapismall.sm",
    "cdn_url": "test-openapismall.sm.mncdn.org",
    "resource_label": "label",
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-26T18:19:08.000000Z",
    "data_source": "origin",
    "gzip_text": false,
    "gzip_image": false,
    "brotli": false,
    "image_optimization": false,
    "webp": true,
    "avif": null,
    "http2": true,
    "status_qs": false,
    "status_secure_token": false
  }
}

Resource created successfully

Create Storage Resource (Small or Large)

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization

Example: 123e4567-e89b-12d3-a456-426614174000

Body

resource_namestringrequired

Example: small-storage

resource_labelstring

Example: labelstorage

data_sourcestringrequired

Example: storage

storage_versionstringrequired

Example: v2

storage_path_uuidstring · uuidrequired

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

storage_path_directorystringrequired

Example: test

resource_typestring · enumrequired

Example: small

Options: small, large

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "small-storage",
    "resource_label": "labelstorage",
    "data_source": "storage",
    "storage_version": "v2",
    "storage_path_uuid": "*****-*****-****-*****",
    "storage_path_directory": "test",
    "resource_type": "small"
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "*****-*****-*****-***",
    "resource_type": "small",
    "resource_name": "small-storage.sm",
    "cdn_url": "small-storage.sm.mncdn.org",
    "resource_label": "labelstorage",
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-27T10:41:47.000000Z",
    "storage_version": "v2",
    "storage_path_uuid": "***-****-*****-*****",
    "storage_path_directory": "test",
    "data_source": "storage",
    "gzip_text": false,
    "gzip_image": false,
    "brotli": false,
    "image_optimization": false,
    "webp": true,
    "avif": null,
    "http2": true,
    "status_qs": false,
    "status_secure_token": false
  }
}

Storage resource created successfully

Create Dynamic Resource

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

resource_namestringrequired

The name of the resource

resource_labelstring

Label for the resource

server_namestringrequired

The name of the server

Example: testtest.com

data_sourcestring · enumrequired

The source of the data

Options: origin

resource_typestring · enumrequired

The type of the resource

Options: dynamic

origin_typestring · enumrequired

The type of the origin

Options: mainstream

origin_settingsobject[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "test",
    "resource_label": "",
    "data_source": "origin",
    "resource_type": "dynamic",
    "origin_type": "mainstream",
    "server_name": "testtest.com",
    "origin_settings": [
      {
        "protocol": "https",
        "origin_url": "dynamic.com",
        "host_header": "host.com",
        "http_port": 80,
        "https_port": 443,
        "is_delete": false,
        "status_origin_s3_presign": false,
        "weight": 50,
        "priority": "primary"
      }
    ]
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "***-****-****-***",
    "resource_type": "dynamic",
    "resource_name": "test.sm",
    "cdn_url": "test.sm.mncdn.org",
    "resource_label": null,
    "ssl_certificate": "sni",
    "created_at": "2024-12-27T08:35:16.000000Z",
    "data_source": "origin",
    "server_name": "testtest.com",
    "gzip_text": false,
    "gzip_image": false,
    "brotli": false,
    "image_optimization": false,
    "webp": true,
    "avif": null,
    "http2": true,
    "status_qs": false,
    "status_secure_token": false
  }
}

Resource created successfully

Create Streaming Resource (RTMP)

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization

Example: 123e4567-e89b-12d3-a456-426614174000

Body

resource_namestringrequired

Example: rtmpopenapi

resource_labelstring

data_sourcestringrequired

Example: rtmp_push

resource_typestringrequired

Example: streaming

auth_usernamestringrequired

Example: rtmpuser

auth_passwordstringrequired

Example: hidden

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "rtmpopenapi",
    "resource_label": "",
    "data_source": "rtmp_push",
    "resource_type": "streaming",
    "auth_username": "rtmpuser",
    "auth_password": "hidden"
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "****-****-****-*******",
    "resource_type": "streaming",
    "resource_name": "rtmpopenapi",
    "cdn_url": "rtmpopenapi.mncdn.com",
    "resource_label": null,
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-27T09:32:36.000000Z",
    "data_source": "rtmp_push",
    "auth_status": true,
    "auth_username": "rtmpuser",
    "gzip_text": false
  }
}

Streaming resource created successfully

List resources

get

/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Query parameters

pageinteger · default: 1

Page number for pagination

sort_fieldstring · enum · default: created_at

Field to sort by

Options: created_at, resource_name, resource_type

sortstring · enum · default: desc

Sort direction

Options: asc, desc

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource'

200

{
  "status": true,
  "meta": {
    "current_page": 1,
    "total": 10,
    "per_page": 15
  },
  "data": [
    {
      "resource_uuid": "****-****-****-*****",
      "resource_type": "small",
      "resource_name": "test-resource.sm",
      "cdn_url": "test-resource.sm.mncdn.org",
      "resource_label": "label",
      "ssl_certificate": "shared_ssl",
      "created_at": "2024-12-26T18:19:08.000000Z",
      "data_source": "origin",
      "gzip_text": false,
      "gzip_image": false,
      "brotli": false,
      "image_optimization": false,
      "webp": true,
      "avif": null,
      "http2": true,
      "status_qs": false,
      "status_secure_token": false
    }
  ]
}

List of resources retrieved successfully

Show Resource

Retrieve detailed information about a specific resource.

get

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}'

200

404

{
  "status": true,
  "data": {
    "resource_uuid": "***-***-****-****",
    "resource_name": "test1.sm",
    "resource_type": "small",
    "resource_platform_type": "cache",
    "cdn_url": "test1.sm.mncdn.com",
    "protocol": "https",
    "origin_url": "test.com",
    "status": "active",
    "updating_status": "up_to_date",
    "created_at": "2024-09-12T09:23:26.000000Z",
    "updated_at": "2024-09-16T10:41:41.000000Z"
  }
}

Successful response with resource details

Delete Resource

Delete a specific resource.

delete

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}'

200

404

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

Successful response indicating resource was deleted

Create Streaming Resource(Origin)

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization

Example: 123e4567-e89b-12d3-a456-426614174000

Body

resource_namestringrequired

Example: streamopenapi

resource_labelstring

origin_urlstring · urirequired

Example: test.com

data_sourcestring · enumrequired

Example: origin

Options: origin

resource_typestring · enumrequired

Example: streaming

Options: streaming

protocolstring · enumrequired

Example: https

Options: http, https

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "streamopenapi",
    "resource_label": "",
    "origin_url": "test.com",
    "data_source": "origin",
    "resource_type": "streaming",
    "protocol": "https"
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "***-****-****-****",
    "resource_type": "streaming",
    "resource_name": "bistreamopenapi",
    "cdn_url": "streamopenapi.mncdn.com",
    "resource_label": null,
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-27T09:30:39.000000Z",
    "data_source": "origin",
    "protocol": "https",
    "origin_url": "test.com",
    "gzip_text": false
  }
}

Streaming resource created successfully

Enable/Disable Resource

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

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

resource_uuidstringrequired

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

Body

statusbooleanrequired

Example: false

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": false
  }'

200

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

Resource successfully enabled/disabled

Create Streaming Resource (FLV)

post

/api/v1/cdn/{organization_uuid}/resource

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization

Example: 123e4567-e89b-12d3-a456-426614174000

Body

resource_namestringrequired

Example: streamingflv

resource_labelstring

Example: test-label

data_sourcestringrequired

Example: stream_flv

resource_typestringrequired

Example: streaming

protocolstringrequired

Example: rtmp

stream_flv_media_serverboolean

Example: false

origin_urlstringrequired

Example: flvtest.com

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_name": "streamingflv",
    "resource_label": "test-label",
    "data_source": "stream_flv",
    "resource_type": "streaming",
    "protocol": "rtmp",
    "stream_flv_media_server": false,
    "origin_url": "flvtest.com"
  }'

200

{
  "status": true,
  "data": {
    "resource_uuid": "***-****-****-****",
    "resource_type": "streaming",
    "resource_name": "streamingflv",
    "cdn_url": "streamingflv.mncdn.com",
    "resource_label": "test-label",
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-27T10:27:34.000000Z",
    "data_source": "stream_flv",
    "protocol": "rtmp",
    "origin_url": "flvtest.com",
    "gzip_text": false
  }
}

Streaming resource created successfully