Origin

Available endpoints:
NameMethodPath
get/v3/origin
post/v3/origin
get/v3/origin/{id}
patch/v3/origin/{id}
delete/v3/origin/{id}
post/v3/origin/aws

List of Origins

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

Responses

200Origin list for CDN Resource setup was returned
// response
[
  {
    "cdns": [
      {
        "id": 0,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "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": 0,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "scheme": "https",
    "usage": {
      "space": 7216780,
      "nodes": 123456789,
      "time": "2021-11-26T13:56:53.598Z"
    },
    "server": {
      "id": "push-XX.cdn77.com",
      "location": "Europe - Frankfurt"
    },
    "type": "storage"
  },
  {
    "cdns": [
      {
        "id": 0,
        "label": "My cdn"
      }
    ],
    "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
    "label": "My origin",
    "scheme": "https",
    "base_dir": "/pictures/images/",
    "host": "my-domain.com",
    "port": 8080,
    "type": "url"
  }
]

Create Your Origin

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

Request bodyrequired

// request body
{
  "base_dir": "/pictures/images/",
  "label": "My URL 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.

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": 0,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "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/{id}

Request parameters

id
requiredstring in path

Origin ID.

Responses

200Detail of the given Origin returned.
// response
{
  "cdns": [
    {
      "id": 0,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "scheme": "https"
}
404Origin not found.

Edit Origin

Change of origin affects all your assigned CDN Resources.

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

Request parameters

id
requiredstring in path

Origin ID.

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",
  "scheme": "https",
  "host": "my.s3.amazonaws.com",
  "port": "1000"
}
aws_access_key_id
string
aws_access_key_secret
string
aws_region
string
base_dir
string
label
string
scheme
string
host
string
port
string

Responses

204Origin updated.
404Origin not found.

Delete Origin

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

Request parameters

id
requiredstring in path

Origin ID.

Responses

204Origin removed.
404Origin not found.

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",
  "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.

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": 0,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "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.