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}
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

200Origin 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",
    "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",
    "usage": {
      "space": 7216780,
      "nodes": 123456789,
      "time": "2024-03-25T10:55:10.385Z"
    },
    "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",
    "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_idrequiredstring

Located in the Security Credentials section of your AWS account.

aws_access_key_secretrequiredstring

Located in the Security Credentials section of your AWS account.

aws_regionrequiredstring

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

Scheme of the AWS Origin.

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

201AWS 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"
}

422Unable to create AWS origin.

Detail of AWS Origin

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

Request parameters

idrequiredstring in path

Origin ID.

Responses

200Detail 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"
}

404Origin 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
portstring
aws_access_key_idstring
aws_access_key_secretstring
aws_regionstring

Responses

204Origin updated.

404Origin not found.

Delete AWS Origin

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

Request parameters

idrequiredstring in path

Origin ID.

Responses

204Origin removed.

404Origin not found.

422Error occurred.

Detail of CDN77 Storage

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

Request parameters

idrequiredstring in path

Origin ID.

Responses

200Detail 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-03-25T10:55:10.384Z"
  },
  "server": {
    "id": "push-XX.cdn77.com",
    "location": "Europe - Frankfurt"
  },
  "type": "storage"
}

404Origin 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": "MISSING EXAMPLE",
  "note": "Note for my Origin",
  "password": "MISSING EXAMPLE"
}
labelstring
notestring

Optional note for the Origin.

passwordstring

Responses

204Storage updated.

404Storage does not exist.

422Unable to create CDN Storage with requested parameters.

Delete CDN77 Storage

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

Request parameters

idrequiredstring in path

Responses

204Storage deleted.

404Storage 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.

schemerequiredstring

Scheme of the URL Origin.

Available values: http,https,

hostrequiredstring

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

Responses

201Origin 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"
}

Detail of Your Origin

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

Request parameters

idrequiredstring in path

Origin ID.

Responses

200Detail 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"
}

404Origin 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
portstring

Responses

204Origin updated.

404Origin not found.

Delete Your Origin

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

Request parameters

idrequiredstring in path

Origin ID.

Responses

204Origin removed.

404Origin not found.

422Error occurred.