# AudioDN API Documentation

> AudioDN (Audio Delivery Network) is an API and component library for managing, processing, and streaming audio content. This documentation covers integration patterns, API endpoints, and embeddable web components.

## About AudioDN

AudioDN provides infrastructure for audio delivery including:
- Audio file uploading and processing
- Automatic variant generation (HQ, LQ, Preview, Waveforms)
- Secure streaming with session-based access control
- Embeddable Player and Uploader web components
- Multi-tenant support with Collections, Tracks, and Creators

## Integration Approaches

AudioDN supports three integration patterns that can be mixed and matched:

### Client-Side
Drop-in web components authenticated with scoped Component API Keys. Best for static sites, prototypes, and projects without a backend.

### Server-Side  
Full API access for custom upload and playback interfaces. Required for mobile apps, custom players, and platforms needing fine-grained access control.

### Hybrid
Backend creates sessions via API, frontend uses ADN components with session IDs. Enables backend business logic (paywalls, subscriptions) with ready-made UI.

## Key Concepts

- **Collection**: A container for organizing tracks (like a folder or album)
- **Track**: An individual audio file with metadata
- **Variant**: A processed version of a track (e.g., HQ streaming, preview clip, waveform)
- **Upload Session**: A time-limited session for uploading one or more tracks
- **Play Session**: A time-limited session granting access to specific tracks and variants
- **Component API Key**: A scoped key for authenticating web components (Player or Uploader)
- **API Access Key**: A full-access key for server-to-server API calls

## Documentation Structure

- `/` - Overview and getting started
- `/authentication` - API authentication with Bearer tokens
- `/variant-types` - Available audio variant types
- `/uploads` - Guide to uploading audio (client-side, server-side, hybrid)
- `/playback` - Guide to playing audio (client-side, server-side, hybrid)
- `/api/organizations` - Organization management endpoints
- `/api/collections` - Collection CRUD endpoints
- `/api/tracks` - Track management endpoints
- `/api/covers` - Cover image endpoints
- `/api/upload-sessions` - Upload session endpoints
- `/api/play-sessions` - Play session endpoints
- `/api/variants` - Variant configuration endpoints

## API Base URL

All API endpoints are prefixed with `/v1/`:
```
https://api.audiodeliverynetwork.com/v1/
```

## Web Components

Embed the Player:
```html
<script src="https://components.audiodeliverynetwork.com/audiodn-player.js"></script>
<audiodn-player api-key="YOUR_PLAYER_KEY" scope="collection" id="COLLECTION_ID"></audiodn-player>
```

Embed the Uploader:
```html
<script src="https://components.audiodeliverynetwork.com/audiodn-uploader.js"></script>
<audiodn-uploader api-key="YOUR_UPLOADER_KEY" collection-id="COLLECTION_ID"></audiodn-uploader>
```

## Contact

- Website: https://audiodeliverynetwork.com
- Dashboard: https://account.audiodeliverynetwork.com
- Documentation: https://docs.audiodeliverynetwork.com