Client Panel

Origin

Available endpoints:
NameMethodPath
get/v3/origin
post/v3/origin/aws
get/v3/origin/aws/{id}
patch/v3/origin/aws/{id}
delete/v3/origin/aws/{id}
post/v3/origin/object-storage
get/v3/origin/object-storage/{id}
patch/v3/origin/object-storage/{id}
delete/v3/origin/object-storage/{id}
get/v3/origin/storage/{id}
patch/v3/origin/storage/{id}
delete/v3/origin/storage/{id}
post/v3/origin/url
get/v3/origin/url/{id}
patch/v3/origin/url/{id}
delete/v3/origin/url/{id}

List of Origins

gethttps://api.cdn77.com/v3/origin

Responses

200 – Origin list for CDN Resource setup was returned

// example of the response
[
  {
    "cdns": [
      {
        "id": 1234567890,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "note": "Note for my Origin",
    "scheme": "https",
    "access_key_id": "KLAMIDYDRAP8CJYC1DN",
    "access_secret": "adkl123SADowqiqwe!432",
    "bucket_name": "my-bucket",
    "created_at": "2024-04-23T08:54:11.788Z",
    "host": "region.cdn77-storage.com",
    "port": 8080,
    "type": "object-storage",
    "usage": {
      "file_count": 0,
      "size_bytes": 0
    }
  },
  {
    "cdns": [
      {
        "id": 1234567890,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "note": "Note for my Origin",
    "scheme": "https",
    "usage": {
      "space": 7216780,
      "nodes": 123456789,
      "time": "2024-04-23T08:54:11.788Z"
    },
    "server": {
      "id": "push-XX.cdn77.com",
      "location": "Europe - Frankfurt"
    },
    "type": "storage"
  },
  {
    "cdns": [
      {
        "id": 1234567890,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "note": "Note for my Origin",
    "scheme": "https",
    "aws_access_key_id": "KLAMIDYDRAP8CJYC1DN",
    "aws_region": "us-east-1",
    "base_dir": "/pictures/images",
    "host": "my.s3.amazonaws.com",
    "port": 1000,
    "type": "aws"
  },
  {
    "cdns": [
      {
        "id": 1234567890,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "note": "Note for my Origin",
    "scheme": "https",
    "base_dir": "/pictures/images",
    "host": "my-domain.com",
    "port": 8080,
    "type": "url"
  }
]

Create AWS Origin

posthttps://api.cdn77.com/v3/origin/aws

Request bodyrequired

// example of the request body
{
  "aws_access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "aws_access_key_secret": "3a1F8jM+xJyDkHdUQazbcq5mDI2gW0vFsFbLi6PW",
  "aws_region": "us-east-1",
  "base_dir": "/pictures/images",
  "label": "My AWS Origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "host": "my.s3.amazonaws.com",
  "port": 1000
}
aws_access_key_idstring

Located in the Security Credentials section of your AWS account.

aws_access_key_secretstring

Located in the Security Credentials section of your AWS account.

aws_regionstring

Located in the Security Credentials section of your AWS account. Possibly stored as AWS_DEFAULT_REGION.

base_dirstring

Directory of the stored content on your AWS Origin. Maximum length is 255. characters

labelrequiredstring

The label helps you to identify your AWS Origin.

notestring

Optional note for the Origin.

schemestring

Available values: http,https,

hostrequiredstring

AWS Origin host without scheme and port. Can be a domain name or an IP address.

portinteger

AWS Origin port. If not specified, the default scheme port is used. Allowed range is between 1 and 65535.

Responses

201 – AWS Origin for CDN Resource setup was added.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "aws_access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "aws_region": "us-east-1",
  "base_dir": "/pictures/images",
  "host": "my.s3.amazonaws.com",
  "port": 1000,
  "type": "aws"
}

422 – Unable to create AWS origin.

Detail of AWS Origin

gethttps://api.cdn77.com/v3/origin/aws/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

200 – Detail of the given Origin returned.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "aws_access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "aws_region": "us-east-1",
  "base_dir": "/pictures/images",
  "host": "my.s3.amazonaws.com",
  "port": 1000,
  "type": "aws"
}

404 – Origin not found.

Edit AWS Origin

Change of origin affects all your assigned CDN Resources.

patchhttps://api.cdn77.com/v3/origin/aws/{id}

Request parameters

idrequiredstring in path

Origin ID.

Request bodyrequired

// example of the request body
{
  "base_dir": "/pictures/images",
  "label": "My AWS Origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "host": "my.s3.amazonaws.com",
  "port": 1000,
  "aws_access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "aws_access_key_secret": "3a1F8jM+xJyDkHdUQazbcq5mDI2gW0vFsFbLi6PW",
  "aws_region": "us-east-1"
}
base_dirstring
labelstring
notestring

Optional note for the Origin.

schemestring
hoststring
portinteger
aws_access_key_idstring
aws_access_key_secretstring
aws_regionstring

Responses

204 – Origin updated.

404 – Origin not found.

422 – Invalid input.

Delete AWS Origin

deletehttps://api.cdn77.com/v3/origin/aws/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

204 – Origin removed.

404 – Origin not found.

422 – Error occurred.

Add CDN77 Object Storage

posthttps://api.cdn77.com/v3/origin/object-storage

Request bodyrequired

// example of the request body
{
  "acl": "public-read",
  "cluster_id": "9880280c-0507-46d1-88f3-71cfee83fa57",
  "label": "My bucket",
  "bucket_name": "my-bucket",
  "note": "Storage for video content"
}
aclstring

Available values: authenticated-read,private,public-read,public-read-write,

cluster_idrequiredstring, format UUIDv4

Cluster ID

labelrequiredstring
bucket_namerequiredstring
notestring

Responses

201 – Object storage was created.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "access_secret": "adkl123SADowqiqwe!432",
  "bucket_name": "my-bucket",
  "created_at": "2024-04-23T08:54:11.785Z",
  "host": "region.cdn77-storage.com",
  "port": 8080,
  "type": "object-storage",
  "usage": {
    "file_count": 0,
    "size_bytes": 0
  }
}

422 – Unable to create Object storage origin.

Detail of CDN77 Object Storage

gethttps://api.cdn77.com/v3/origin/object-storage/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

200 – Detail of the given Origin returned.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "access_key_id": "KLAMIDYDRAP8CJYC1DN",
  "access_secret": "adkl123SADowqiqwe!432",
  "bucket_name": "my-bucket",
  "created_at": "2024-04-23T08:54:11.787Z",
  "host": "region.cdn77-storage.com",
  "port": 8080,
  "type": "object-storage",
  "usage": {
    "file_count": 0,
    "size_bytes": 0
  }
}

404 – Origin not found.

Edit CDN77 Object Storage

patchhttps://api.cdn77.com/v3/origin/object-storage/{id}

Request parameters

idrequiredstring in path

Origin ID.

Request bodyrequired

// example of the request body
{
  "access_keys": [
    {
      "access_key_id": "9880280c-0507-46d1-88f3-71cfee83fa57",
      "type": "read"
    }
  ],
  "label": "My label",
  "note": "My note"
}
access_keysarray of objects
labelstring
notestring

Responses

204 – Origin updated

404 – Origin not found.

422 – Origin edit failed.

Delete CDN77 Object Storage

deletehttps://api.cdn77.com/v3/origin/object-storage/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

204 – Origin removed.

404 – Origin not found.

422 – Error occurred.

Detail of CDN77 Storage

gethttps://api.cdn77.com/v3/origin/storage/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

200 – Detail of the given Origin returned.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "usage": {
    "space": 7216780,
    "nodes": 123456789,
    "time": "2024-04-23T08:54:11.787Z"
  },
  "server": {
    "id": "push-XX.cdn77.com",
    "location": "Europe - Frankfurt"
  },
  "type": "storage"
}

404 – Origin not found.

Edit CDN77 Storage

patchhttps://api.cdn77.com/v3/origin/storage/{id}

Request parameters

idrequiredstring in path

Request bodyrequired

// example of the request body
{
  "label": "My storage",
  "note": "Note for my Origin",
  "password": "p455w0rd"
}
labelstring
notestring

Optional note for the Origin.

passwordstring

Responses

204 – Storage updated.

404 – Storage does not exist.

422 – Unable to create CDN Storage with requested parameters.

Delete CDN77 Storage

deletehttps://api.cdn77.com/v3/origin/storage/{id}

Request parameters

idrequiredstring in path

Responses

204 – Storage deleted.

404 – Storage does not exist.

Create Your Origin

posthttps://api.cdn77.com/v3/origin/url

Request bodyrequired

// example of the request body
{
  "base_dir": "/pictures/images",
  "label": "My URL Origin",
  "note": "Note for my Origin",
  "port": 8080,
  "scheme": "https",
  "host": "my-domain.com"
}
base_dirstring

Directory where the content is stored on the URL Origin. It must not end with the slash. Maximum length is 255.

labelrequiredstring

The label helps you to identify your URL Origin.

notestring

Optional note for the Origin.

portinteger

URL Origin port. If not specified, default scheme port is used. Allowed range is between 1 and 65535.

schemestring

Available values: http,https,

hostrequiredstring

URL Origin host without scheme and port. Can be domain name or IP address.

Responses

201 – Origin created.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "base_dir": "/pictures/images",
  "host": "my-domain.com",
  "port": 8080,
  "type": "url"
}

422 – Unable to create URL origin.

Detail of Your Origin

gethttps://api.cdn77.com/v3/origin/url/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

200 – Detail of the given Origin returned.

// example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "base_dir": "/pictures/images",
  "host": "my-domain.com",
  "port": 8080,
  "type": "url"
}

404 – Origin not found.

Edit Your Origin

Change of origin affects all your assigned CDN Resources.

patchhttps://api.cdn77.com/v3/origin/url/{id}

Request parameters

idrequiredstring in path

Origin ID.

Request bodyrequired

// example of the request body
{
  "base_dir": "/pictures/images",
  "label": "My AWS Origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "host": "my.s3.amazonaws.com",
  "port": 1000
}
base_dirstring
labelstring
notestring

Optional note for the Origin.

schemestring
hoststring
portinteger

Responses

204 – Origin updated.

404 – Origin not found.

422 – Invalid input.

Delete Your Origin

deletehttps://api.cdn77.com/v3/origin/url/{id}

Request parameters

idrequiredstring in path

Origin ID.

Responses

204 – Origin removed.

404 – Origin not found.

422 – Error occurred.