Inline Share
Las Inline Share Keys te permiten adjuntar una clave a una URL que cualquiera puede abrir — sin cabecera Authorization, sin handshake de sesión de reproducción. Cada solicitud valida la clave, firma una URL CDN de corta duración para la variante de la clave y devuelve una redirección 302 al archivo de audio.
Alto uso
Los enlaces de compartir son públicos. Cualquiera con la URL puede reproducir hasta que la clave caduque o se elimine. Cada solicitud cuenta para el uso de reproducción y la facturación. Establece una fecha de caducidad cuando sea posible y elimina las claves que ya no necesites.
Crear una Share Key
En el panel de AudioDN, ve a Settings → API Keys y crea una Inline Share Key. Debes seleccionar exactamente una variante. Opcionalmente limita la clave a una colección o pista.
/v1/stream/:track_id/:api_key Valida una Inline Share Key y redirige a una URL CDN firmada para la variante de la clave
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
track_id | uuid | Obligatorio | ID de la pista a reproducir (parámetro de ruta) |
api_key | string | Obligatorio | Inline Share Key incluyendo el prefijo de org (parámetro de ruta) |
Respuesta
HTTP/1.1 302 Found
Location: https://{org_domain}/{file_path}?verify={hmac_token}
Cache-Control: no-storeNo se devuelve cuerpo JSON. El cliente sigue la redirección para reproducir audio desde el dominio CDN de tu organización. La URL firmada es válida durante una hora; solicita de nuevo la URL de compartir para generar un token nuevo.
Alcance de la clave
- Toda la organización — cualquier pista de tu organización (predeterminado)
- Colección — solo pistas de la colección especificada
- Pista — solo la pista especificada (cuando también se establece la colección)
La única variante de la clave siempre se aplica. Las solicitudes de pistas fuera del alcance de la clave devuelven 404.