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/storage
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
// 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": "2022-09-27T07:59:25.811Z"
    },
    "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

// 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_id
requiredstring

Located in the Security Credentials section of your AWS account.

aws_access_key_secret
requiredstring

Located in the Security Credentials section of your AWS account.

aws_region
requiredstring

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

base_dir
string

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

label
requiredstring

The label helps you to identify your AWS Origin.

note
string

Optional note for the Origin.

scheme
string

Scheme of the AWS Origin.

Available values:

http
,
https
,

host
requiredstring

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

port
integer

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.
// 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

id
requiredstring in path

Origin ID.

Responses

200Detail of the given Origin returned.
// 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

id
requiredstring in path

Origin ID.

Request bodyrequired

// 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_dir
string
label
string
note
string

Optional note for the Origin.

scheme
string
host
string
port
string
aws_access_key_id
string
aws_access_key_secret
string
aws_region
string

Responses

204Origin updated.
404Origin not found.

Delete AWS Origin

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

Request parameters

id
requiredstring in path

Origin ID.

Responses

204Origin removed.
404Origin not found.

Create CDN77 Storage

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

Request bodyrequired

// request body
{
  "location": "push-XX.cdn77.com",
  "label": "My new Storage",
  "note": "Note for my Origin",
  "password": "adwAFIoq4422hhTps"
}
location
string
label
string
note
string

Optional note for the Origin.

password
string

Responses

201CDN Storage was created.
// response
{
  "id": "9880280c-0507-46d1-88f3-71cfee83fa57",
  "label": "My storage",
  "note": "Note for my Origin",
  "server": {
    "hostname": "push-XX.cdn77.com",
    "location": "North America - Chicago"
  },
  "username": "user_1234"
}
404Unable to create CDN Storage, requested server doesn't exist.
422Unable to create CDN Storage with the requested parameters.

Detail of CDN77 Storage

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

Request parameters

id
requiredstring in path

Origin ID.

Responses

200Detail of the given Origin returned.
// 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": "2022-09-27T07:59:25.810Z"
  },
  "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

id
requiredstring in path

Request bodyrequired

// request body
{
  "label": "MISSING EXAMPLE",
  "note": "Note for my Origin",
  "password": "MISSING EXAMPLE"
}
label
string
note
string

Optional note for the Origin.

password
string

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

id
requiredstring in path

Responses

204Storage deleted.
404Storage does not exist.

Create Your Origin

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

Request bodyrequired

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

Directory where the content is stored on the URL Origin. Maximum length is 255.

label
requiredstring

The label helps you to identify your URL Origin.

note
string

Optional note for the Origin.

port
integer

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

scheme
requiredstring

Scheme of the URL Origin.

Available values:

http
,
https
,

host
requiredstring

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

Responses

201Origin created.
// 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

id
requiredstring in path

Origin ID.

Responses

200Detail of the given Origin returned.
// 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

id
requiredstring in path

Origin ID.

Request bodyrequired

// 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_dir
string
label
string
note
string

Optional note for the Origin.

scheme
string
host
string
port
string

Responses

204Origin updated.
404Origin not found.

Delete Your Origin

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

Request parameters

id
requiredstring in path

Origin ID.

Responses

204Origin removed.
404Origin not found.