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 → Integration → API 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"
const res = await fetch('https://api.5centscdn.com/v2/account', {
headers: { 'X-API-KEY': 'YOUR_API_KEY' }
});
const data = await res.json();
console.log(data);
import requests
r = requests.get(
'https://api.5centscdn.com/v2/account',
headers={'X-API-KEY': 'YOUR_API_KEY'}
)
print(r.json())
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"
const res = await fetch('https://api.5centscdn.com/v2/zones', {
headers: { 'X-API-KEY': 'YOUR_API_KEY' }
});
const data = await res.json();
console.log(data);
import requests
r = requests.get(
'https://api.5centscdn.com/v2/zones',
headers={'X-API-KEY': 'YOUR_API_KEY'}
)
print(r.json())
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
| Guide | Description |
|---|---|
| Authentication | How API key auth works and best practices |
| Zones | Create and configure delivery zones |
| Live Streams | Set up live stream ingest and playback |
| Edge Rules | Define path-based routing and caching rules |