API Reference
Authentication
Authenticate your API calls by transmitting your API key in the standard Authorization HTTP request header.
Authorization: Bearer sec_live_YOUR_TOKEN_HERE
Rate Limits & Headers
Standard tier API keys are provisioned with 10,000 requests per minute per IP pool. Responses include standard rate limit headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Allowed ceiling within current window (10000) |
X-RateLimit-Remaining | Remaining request units in active window |
X-RateLimit-Reset | Unix epoch seconds timestamp of quota reset |
Core Endpoints
GET
/v1/health
Returns health verification of all ingress controllers and edge dispatch nodes.
curl -X GET "https://api.mr-marakesh.duckdns.org/v1/health" -H "Authorization: Bearer sec_live_token"
POST
/v1/deployments
Dispatches an automated deployment task to the target compute cluster.
curl -X POST "https://api.mr-marakesh.duckdns.org/v1/deployments" -H "Authorization: Bearer sec_live_token" -H "Content-Type: application/json" -d '{
"environment": "production",
"cluster_region": "eu-central-1",
"replicas": 6,
"strategy": "rolling_zero_downtime"
}'