OverviewQuickstart

Quickstart

Make your first 5centsCDN API call. By the end of this guide you will have made your first authenticated API call and listed your CDN zones.

Step-by-step

Create an API key

Log in to your dashboard, open the Settings menu → IntegrationAPI to reach your API Keys list, then click Add New.

  • Name (required)
  • Description (required)
  • Permissions (required, choose at least one) — Create, Read, Update, Delete
  • IP Whitelist (optional) — one IP or CIDR per line; leave blank to allow any IP

Create stays disabled until Name, Description, and at least one Permission are set.

Copy your key — it's shown only once

Creating a key opens its detail page with a banner showing the plaintext API key. Once you leave this page, only its SHA-256 Fingerprint remains visible — enough to identify the key, but never the key itself.

This is the only time the plaintext key is displayed — 5centsCDN does not store it. If you lose it, delete the key and create a new one.

Never paste your API key into public code, browser consoles, or Git repositories.

Verify your key works

Make a test call to the account endpoint. A 200 response means your key is valid.

curl -X GET https://api.5centscdn.com/v2/account \
  -H "X-API-KEY: YOUR_API_KEY"

List your zones

Fetch all CDN zones on your account.

curl -X GET https://api.5centscdn.com/v2/zones \
  -H "X-API-KEY: YOUR_API_KEY"

Expected response:

{
  "status": "success",
  "data": [
    {
      "id": 12345,
      "name": "my-zone",
      "type": "HTTP",
      "status": "active"
    }
  ]
}

Explore the API reference

You are ready. Browse the full reference in the sidebar — every endpoint includes request/response schemas and a live playground to test calls directly.


What's next

GuideDescription
AuthenticationHow API key auth works and best practices
ZonesCreate and configure delivery zones
Live StreamsSet up live stream ingest and playback
Edge RulesDefine path-based routing and caching rules