CDB REST API
One API token authenticates to every CDB product in the CDB Technical Web Portal — Cloud, CDN, DNS, Storage, CDB EdgeCompute, and others — so authentication, request format, and response patterns are consistent across all of them.
Learning path
Start here and follow the guides in order:
| Step | Guide | What it covers |
|---|---|---|
| 1 | API basics | Terminal, curl, JSON, environment variables — the tools and concepts used throughout |
| 2 | Authentication | Create an API token and send it with every request |
| 3 | First API call | Verify the token, find project and region IDs, make the first resource call |
| 4 | Async operations | Create and delete calls return a task ID — here is how to wait for the result |
| 5 | Error handling | Error response format, common error types, and retry strategy |
| 6 | Pagination | Retrieve large result sets with limit and offset |
| 7 | Tools | Postman, HTTPie, VS Code REST Client — setup and usage |
| 8 | SDKs | Python, Go, and JavaScript clients for production code |
Base URLs
Each CDB product has a dedicated base URL. The same permanent API token authenticates to all of them — no separate credentials per product:
| Product | Base URL |
|---|---|
| Cloud — VMs, Kubernetes, LB, Volumes | https://api.cdb-staging.cdn.orange.com/cloud |
| GPU Cloud | https://api.cdb-staging.cdn.orange.com/cloud |
| Everywhere Inference | https://api.cdb-staging.cdn.orange.com/cloud |
| IAM (users, tokens) | https://api.cdb-staging.cdn.orange.com/iam |
| CDN | https://api.cdb-staging.cdn.orange.com/cdn |
| Managed DNS | https://api.cdb-staging.cdn.orange.com/dns |
| Object Storage | https://api.cdb-staging.cdn.orange.com/storage |
| CDB EdgeCompute | https://api.cdb-staging.cdn.orange.com/edgecompute |
| Streaming | https://api.cdb-staging.cdn.orange.com/streaming |
| WAAP | https://api.cdb-staging.cdn.orange.com/waap |
| DDoS Protection | https://api.cdb-staging.cdn.orange.com/security |