# File Hosting Service API & Documentation

A fast, lightweight, and clean file hosting platform supporting arbitrary file uploads under 10MB.

## Upload Endpoint
- **URL**: https://files.vivo50.eu.org/upload
- **Method**: POST
- **Encoding**: multipart/form-data
- **CORS**: Enabled (Origin: *)
- **Field Name**: 'file' (Binary file)
- **Constraint**: File size must not exceed 10MB.

### Example cURL Command
```bash
curl -F "file=@example.jpg" https://files.vivo50.eu.org/upload
```

### Example JSON Response
```json
{
  "success": true,
  "file_name": "example.jpg",
  "size": 1048576,
  "mime_type": "image/jpeg",
  "url": "https://files.vivo50.eu.org/files/..."
}
```

## Retrieval & Proxy
- Files are served via `https://files.vivo50.eu.org/files/*`.
- All files are public and served with persistent HTTP caching (max-age=31536000, 1 year).