📤 Upload Files
POST
/api/files
Upload a new file with automatic thumbnail generation
curl -X POST \
-H "X-Storage-Token: YOUR_TOKEN" \
-F "file=@document.pdf" \
https://yourdomain.com/api/files
Rate Limit:
30 uploads per minute
📋 Get Metadata
GET
/api/files/{id}
Retrieve file information and metadata
curl -H "X-Storage-Token: YOUR_TOKEN" \
https://yourdomain.com/api/files/123
Returns:
File name, size, MIME type, URLs
🖼️ View/Download
GET
/api/files/{id}/render
Download file or get optimized thumbnail
GET /api/files/123/render \
?size=medium \
&format=webp \
&quality=85
Parameters:
size: thumbnail|small|medium|large
format: webp|jpeg|png
🗑️ Delete
DELETE
/api/files/{id}
Delete file and all thumbnails
curl -X DELETE \
-H "X-Storage-Token: YOUR_TOKEN" \
https://yourdomain.com/api/files/123
🔐 Authentication
All API endpoints (except /api and /api/status) require authentication via the X-Storage-Token header:
X-Storage-Token: your_api_key_here
🔍 System Status
Check the health and status of all backend systems:
GET /api/status
Returns: Database, filesystem, storage disks, cache, and configuration status