Welcome
SCloud CDN offers a powerful API for high-performance content delivery, on-the-fly image processing, and secure file management.
Base URLs
The API is split across two domains to optimize for delivery performance and upload handling:
| Purpose | Base URL | Restriction |
|---|
| Basic Endpoint | https://cdn.sacul.cloud | Global access |
| Premium Endpoint | https://upload-cdn.sacul.cloud | Pro subscription required |
The cdn.sacul.cloud domain has a request body limit of 100MB, suitable for most file uploads.
Endpoints
Authentication
All management operations (Upload/Delete) require authentication. Content delivery is generally public unless configured otherwise.
Methods
-
Bearer Token (Recommended)
Add the following header to your requests:
Authorization: Bearer <your-api-key>
-
Query Parameter
Append the key to your URL:
Rate Limits
We implement rate limiting to ensure fair usage and stability. The limits differ based on the type of API interaction and your subscription plan.
User & Developer API
Applies to management operations such as bucket creation, editing, and organization management.
| Limit | Scope |
|---|
| 1,000 req/min | Global per-user limit |
CDN API
Applies to content delivery (GET) and file uploads (POST).
GET Requests
POST Requests
Upload limits vary by plan:
| Plan | Limit |
|---|
| Free | 100 req/min |
| Starter | 300 req/min |
| Pro | 1,000 req/min |
| Business | Custom |
Exceeding these limits will result in a 429 Too Many Requests response.
