Partage en ligne
Les clés Inline Share vous permettent d’attacher une clé à une URL que n’importe qui peut ouvrir — pas d’en-tête Authorization, pas de négociation de session de lecture. Chaque requête valide la clé, signe une URL CDN de courte durée pour la variante de la clé, et renvoie une redirection 302 vers le fichier audio.
Utilisation élevée
Les liens de partage sont publics. Quiconque possède l’URL peut streamer jusqu’à expiration ou suppression de la clé. Chaque requête compte dans l’utilisation de lecture et la facturation. Définissez une date d’expiration lorsque c’est possible et supprimez les clés dont vous n’avez plus besoin.
Créer une clé de partage
Dans le tableau de bord AudioDN, allez dans Settings → API Keys et créez une Inline Share Key. Vous devez sélectionner exactement une variante. Limitez optionnellement la clé à une collection ou une piste.
/v1/stream/:track_id/:api_key Valide une clé Inline Share et redirige vers une URL CDN signée pour la variante de la clé
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
track_id | uuid | Obligatoire | Identifiant de la piste à streamer (paramètre de chemin) |
api_key | string | Obligatoire | Clé Inline Share incluant le préfixe d'organisation (paramètre de chemin) |
Réponse
HTTP/1.1 302 Found
Location: https://{org_domain}/{file_path}?verify={hmac_token}
Cache-Control: no-storeAucun corps JSON n’est renvoyé. Le client suit la redirection pour streamer l’audio depuis le domaine CDN de votre organisation. L’URL signée est valide pendant une heure ; redemandez l’URL de partage pour générer un nouveau jeton.
Portée de la clé
- Toute l’organisation — n’importe quelle piste de votre organisation (par défaut)
- Collection — uniquement les pistes de la collection spécifiée
- Piste — uniquement la piste spécifiée (lorsque la collection est aussi définie)
La variante unique de la clé est toujours appliquée. Les requêtes pour des pistes hors de la portée de la clé renvoient 404.