Documentation
Overview
CDN Platform is a read-oriented HTTP API. All responses are JSON encoded in UTF-8.
Quick start
Every resource is reachable under https://media.kirsovo.win/api/v1. No SDK is required.
Authentication
Requests carry a project key in the Authorization header. Keys are scoped per environment and may be rotated without downtime.
Errors
Errors return a JSON object with an error.code and error.message. The HTTP status carries the same meaning as the code.
Rate limits
Limits are applied per key. Exceeding a limit returns 429 with a Retry-After header.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1 | Version index and resource map. |
| GET | /api/v1/regions | Points of presence and their current state. |
| GET | /api/v1/cache | Cache configuration and current hit ratio. |
| GET | /api/v1/assets | Recently requested assets and their cache status. |
| GET | /api/v1/limits | Request ceilings enforced at the edge. |
| GET | /api/v1/status | Machine-readable service status. |