Duckdns Developer Docs v2.4.2 LTS

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:

HeaderDescription
X-RateLimit-LimitAllowed ceiling within current window (10000)
X-RateLimit-RemainingRemaining request units in active window
X-RateLimit-ResetUnix 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" }'