Duckdns Platform Overview
The Duckdns platform exposes a high-throughput, low-latency programmable interface for distributed workload management, real-time telemetry streaming, and automated resource scheduling.
Base Endpoint: All API requests are served over HTTPS with TLS 1.3 encryption at
https://api.mr-marakesh.duckdns.org/v1.
Quickstart in 3 Minutes
1. Provision your API access credential from the management portal.
2. Send a cluster health probe verification request:
curl -s -X GET "https://api.mr-marakesh.duckdns.org/v1/health" -H "Authorization: Bearer sec_live_829f0a28b61c94" -H "Accept: application/json"
Expected 200 OK Response:
{
"status": "OPERATIONAL",
"version": "2.4.2",
"region": "eu-central-1",
"cluster_id": "cls_9941a80c",
"active_nodes": 48
}
Core Platform Concepts
The system operates around three fundamental primitives:
- Compute Workers: Stateless execution nodes running hardened sandboxed containers.
- Telemetry Pipelines: OpenTelemetry-compliant continuous metrics and event streams.
- Dispatcher Mesh: High-availability gRPC routing mesh coordinating task queues.
Official SDKs
| Language | Package | Command |
|---|---|---|
| Go | go.pkg/duckdns-sdk |
go get go.pkg/duckdns-sdk@v2 |
| Python | duckdns-client |
pip install duckdns-client |
| Node / TS | @duckdns/sdk |
npm install @duckdns/sdk |