🎵 Spooler Media Library

Audio & Video Processing API ● LIVE

What is this?

A lightweight API for uploading, storing, and processing audio and video files. All uploads are automatically converted to MP3 format for downstream use.

🔐 Authentication Required

All API endpoints require a bearer token. Include the token in the Authorization header:

Authorization: Bearer YOUR_TOKEN_HERE

Key Endpoints

GET /api/v1/media

List all media files (supports filtering and pagination)

POST /api/v1/media

Upload a new media file (multipart/form-data)

GET /api/v1/media/:id

Get details for a specific media file

GET /api/v1/media/:id/download

Get download URL (original or MP3 variant)

GET /api/v1/media/stats

Get counts by status (pending/processing/done/failed)

Quick Links

📊 API Stats ⚙️ Sidekiq Dashboard ✅ Health Check

Example Usage

# Upload a file
curl -X POST https://media.spooler.fm/api/v1/media \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -F "file=@/path/to/audio.wav"

# Get stats
curl https://media.spooler.fm/api/v1/media/stats \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

# List all files
curl https://media.spooler.fm/api/v1/media \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"