Delivery Overview

Tuzzle delivers files through a CDN service that handles image processing, caching, access control, and format negotiation.

Delivery Flow

Client Request
    ↓
Access Validation (via API)
    ↓
Check Cache
    ├─ Cache Hit → Serve immediately
    └─ Cache Miss ↓
Fetch Original
    ↓
Apply Transformations
    ↓
Cache Result
    ↓
Return Response

CDN URL Structure

https://cdn.tzzl.io/{space_handle}/{storage_path}

For example:

https://cdn.tzzl.io/a1b2c3/image-01HQ...

Add query parameters for transformations:

https://cdn.tzzl.io/a1b2c3/image-01HQ...?w=400&h=300&f=webp

Access Validation

On every request, the CDN validates file access through the API's internal delivery endpoints. This check:

• Verifies the file exists
• Confirms the space handle in the URL matches the file's space
• Retrieves access control settings (public, private, or authenticated)
• Returns file metadata (dimensions, blurhash, face detections)

Response Headers

File Types

Tuzzle delivers any file type stored in cloud storage. Image transformations (resize, crop, format conversion) only apply to image files. Non-image files are served as-is.

Error Responses