✓ All systems operational — view status

Edge Management API v1

RESTful interface for automated cache invalidation, point of presence health monitoring, and real-time egress metrics.

Base URL

All API requests must be made over HTTPS. Management endpoints are served from:

https://api.mediabyte.tech/v1/

Direct edge telemetry endpoints are also accessible via individual regional edge hostnames under /api/.

Authentication

MediaByte uses standard Bearer Token authentication. Include your API token in the Authorization header of every request:

Authorization: Bearer <your_api_token>

Tokens are issued upon account provisioning. To request an enterprise API token, contact our NOC & sales team.

Authentication Errors

Requests lacking credentials return 401 Unauthorized:

$ curl -i https://api.mediabyte.tech/v1/status HTTP/2 401 content-type: application/json {"error":"unauthorized","message":"API key required"}

Requests with invalid or expired credentials return 403 Forbidden:

$ curl -i -H "Authorization: Bearer invalid_token" https://api.mediabyte.tech/v1/status HTTP/2 403 content-type: application/json {"error":"forbidden","message":"Invalid or inactive API key"}

Endpoints

1. Network Status

GET /v1/status — Returns the overall operational health and active PoP count across all regions.

$ curl -H "Authorization: Bearer <token>" https://api.mediabyte.tech/v1/status { "status": "operational", "pops": 8, "regions": ["eu", "ru", "na"], "version": "2.14.3" }

2. Edge Points of Presence

GET /v1/pops — Retrieves real-time metadata and supported media transport protocols for all active delivery nodes.

$ curl -H "Authorization: Bearer <token>" https://api.mediabyte.tech/v1/pops { "total": 8, "pops": [ { "id": "fi-hel-01", "city": "Helsinki", "country": "FI", "region": "eu", "status": "operational", "protocols": ["hls", "dash", "rtc"] }, { "id": "nl-dro-01", "city": "Dronten", "country": "NL", "region": "eu", "status": "operational", "protocols": ["hls", "dash", "rtc"] }, { "id": "de-fra-01", "city": "Frankfurt", "country": "DE", "region": "eu", "status": "operational", "protocols": ["hls", "dash", "rtc"] } ] }

3. Cache Invalidation (Purge)

POST /v1/purge — Immediately purges specified URL paths or wildcard prefixes across all edge caches. Propagation completes within ~50ms.

$ curl -X POST -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{"paths": ["/live/stream.m3u8", "/assets/*"]}' https://api.mediabyte.tech/v1/purge { "status": "success", "purged": true, "propagation_ms": 42 }

4. Egress Telemetry & Metrics

GET /v1/stats — Summarizes total request volume, egress bandwidth, and edge cache hit ratio over a specified time window.

Query parameters:

  • range: Time window (1h, 24h, 7d). Default: 24h.
  • pop: Optional PoP filter (e.g. nl-dro-01). Default: aggregate all.
$ curl -H "Authorization: Bearer <token>" https://api.mediabyte.tech/v1/stats?range=24h { "range": "24h", "total_requests": 184520, "cache_hit_ratio": 0.988, "bandwidth_gb": 612.4 }

HTTP Status Codes

Code Description Classification
200 OK Request processed successfully and response payload returned. Success
400 Bad Request Malformed JSON body or missing required query parameter. Client Error
401 Unauthorized Missing or malformed Authorization: Bearer header. Auth Required
403 Forbidden Invalid API token, revoked key, or insufficient permissions. Forbidden
404 Not Found Requested endpoint, region, or resource identifier not found. Not Found
429 Too Many Requests Rate limit exceeded (>600 requests/minute per token). Rate Limit

Rate Limits

Management and purge endpoints are rate-limited to 600 requests/minute per API token. Media delivery and segment streaming traffic over edge hostnames is completely unthrottled.