AetherCDN API

Programmatic access to streaming, token management, and delivery operations.

Base URL: https://api.aeticdn.net

Authentication

Send your API key in the Authorization header using the Bearer scheme.

GET https://api.aeticdn.net/v1/ping
Authorization: Bearer ${YOUR_API_KEY}

API Keys

Keys are bearer tokens used to authorize API requests.

Format

Prefix: ak_live_
Length: 40-48 chars
Example: ak_live_BQf1JvG3nE0w7ZtP9xRk2aLmNcVyHsQd

Scopes

streams:read — Read stream metadata
streams:write — Create/modify streams
tokens:issue — Issue playback tokens

Endpoints

GET/v1/ping

Health check endpoint.

{
  "ok": true,
  "message": "pong",
  "region": "iad1"
}

POST/v1/streams

Create a new stream token.

// Request
{
  "origin": "https://cdn.example.com/video.mp4",
  "ttl": 3600
}

// Response
{
  "id": "str_1q2w3e4r",
  "token": "tok_a1b2c3d4",
  "expires_in": 3600
}

GET/v1/streams/{id}

Retrieve a stream.

{
  "id": "str_1q2w3e4r",
  "status": "ready",
  "origin": "https://cdn.example.com/video.mp4"
}

DELETE/v1/streams/{id}

Delete a stream.

{
  "deleted": true,
  "id": "str_1q2w3e4r"
}

Examples

curl -X POST https://api.aeticdn.net/v1/streams \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "https://cdn.example.com/video.mp4",
    "ttl": 3600
  }'

Errors

All errors are returned with standard HTTP codes and a JSON payload:

{
  "error": {
    "code": "invalid_request",
    "message": "Details about what went wrong"
  }
}