Skip to main content

Overview

Shard Cloud CDN is a fully managed file delivery network — think S3 + CloudFront in one step. Upload your images, videos, documents, or any supported file, and we automatically serve them through a global edge network with caching, compression, and expiration handling built in. The goal is simple: upload a file and get a URL. No infrastructure to configure, no cache rules to write, no CDN invalidation to think about. Every plan includes a free CDN storage quota. You can check the CDN quota included in each plan on the pricing page.

Built-in Features

Edge Caching

Files are cached at edge locations worldwide. Your users get the fastest possible response times regardless of where they are.

Image Compression

Images are automatically compressed and optimized on delivery without quality loss. No extra configuration needed.

Expiration Handling

Set an optional expire_at timestamp on any file. Expired files are automatically cleaned up — great for temporary assets, signed URLs, or time-limited content.

Folder Organization

Organize files into folders using the optional folder parameter. Purge entire folder caches in a single API call.

File Size Limits

ConstraintValue
Minimum file size6 KB
Maximum file size100 MB

Supported File Types

The CDN validates files by their MIME type and magic bytes. We support images, videos, audio, documents (PDF), archives, and text formats (JSON, CSV). For the full list of accepted MIME types, see the Supported File Types page.

Quick Start

Upload a file:
curl -X POST https://shardcloud.app/api/cdn/files \
  -H "Authorization: Bearer {api_token}" \
  -F "file=@photo.png" \
  -F "filename=photo.png" \
  -F "folder=avatars"
The response includes a url field — that’s your globally cached CDN link, ready to use. List your files:
curl https://shardcloud.app/api/cdn/files \
  -H "Authorization: Bearer {api_token}"
Check your usage:
curl https://shardcloud.app/api/cdn/stats \
  -H "Authorization: Bearer {api_token}"

CDN API Reference

For the full list of endpoints, request/response schemas, and parameters, see the CDN API Reference.