AudioDN pour les développeurs

Votre backend audio est prêt quand vous l’êtes.

Développez avec notre API REST, utilisez nos web components maintenus ou gérez l’audio directement depuis le tableau de bord.

Commencez par la plus petite intégration adaptée à votre produit. Vous pourrez étendre ou modifier l’intégration à mesure que votre application grandit.

Deux décisions. Pas d’architecture compliquée.

Envoyer des pistes et lire ou accéder aux pistes sont indépendants. Configurez l’un ou les deux. Ne posez une question que si la réponse change les instructions suivantes.

Téléverser des tracks

Choisissez qui crée l’upload session, puis — si nécessaire — comment les fichiers sont transférés. Les choix d’upload et de lecture sont indépendants.

Les choix d’upload et de lecture sont indépendants. Un produit peut téléverser d’une façon et lire l’audio d’une autre.

Qui doit créer ou autoriser l’upload session ?
Comment l’utilisateur doit-il transférer les fichiers ?

Votre flux d’upload

Composants web AudioDN Uploader ou (voice) Recorder avec une Client-Side Upload key

Une Client-Side Upload key limitée vit dans la page ou l’app → le composant web AudioDN Uploader ou (voice) Recorder crée l’upload session → AudioDN téléverse et traite les fichiers.

Identifiant
Client-Side Upload key
Où vit l’identifiant
Dans le navigateur ou l’app native (limitée)
Qui décide si l’upload est autorisé
La portée de la clé (et la configuration optionnelle de collection) décide de ce qui peut être téléversé
Qui fournit l’interface
Composants web AudioDN Uploader ou (voice) Recorder
Qui effectue les étapes d’upload
Le composant AudioDN effectue les étapes d’upload individuelles
Backend
Aucun backend requis
  1. 1 Créer une Client-Side Upload key limitée
  2. 2 Ajouter le composant web AudioDN Uploader ou (voice) Recorder
  3. 3 Les utilisateurs sélectionnent ou enregistrent de l’audio
  4. 4 AudioDN crée la session, le(s) track(s) et les uploads
  5. 5 Attendre la fin du traitement
  • Une Client-Side Upload key ne peut que créer des upload sessions — pas lire ni supprimer des tracks.
  • Ne mettez jamais une API Access key ni un secret URL Signing dans le code navigateur ou mobile.

Votre flux d’upload

Upload client personnalisé avec une Client-Side Upload key

Une Client-Side Upload key limitée vit dans votre app → votre app crée une upload session → crée un track par fichier → téléverse chaque fichier → AudioDN traite les fichiers.

Identifiant
Client-Side Upload key
Où vit l’identifiant
Dans le navigateur ou l’app native (limitée)
Qui décide si l’upload est autorisé
La portée de la clé décide de ce qui peut être téléversé
Qui fournit l’interface
Votre interface web ou native personnalisée
Qui effectue les étapes d’upload
Votre application effectue les étapes d’upload individuelles
Backend
Aucun backend requis
  1. 1 Créer une Client-Side Upload key limitée
  2. 2 Créer une upload session
  3. 3 Créer un track pour chaque fichier
  4. 4 Téléverser chaque fichier vers son URL d’upload renvoyée
  5. 5 Attendre le traitement AudioDN
  • Une Client-Side Upload key ne peut que créer des upload sessions — pas lire ni supprimer des tracks.
  • Ne mettez jamais une API Access key ni un secret URL Signing dans le code navigateur ou mobile.
  • Chaque fichier a besoin de son propre track et de sa propre URL d’upload. Une upload session peut autoriser de nombreux fichiers, mais chaque fichier nécessite toujours une requête par track.

Votre flux d’upload

Upload session créée côté serveur avec les composants web AudioDN Uploader ou (voice) Recorder

Votre serveur approuve l’upload → crée une upload session → la passe au composant web AudioDN Uploader ou (voice) Recorder → AudioDN téléverse et traite les fichiers.

Identifiant
API Access key
Où vit l’identifiant
Sur votre serveur uniquement
Qui décide si l’upload est autorisé
Votre serveur (connexions, permissions, quotas, etc.)
Qui fournit l’interface
Composants web AudioDN Uploader ou (voice) Recorder
Qui effectue les étapes d’upload
Le composant AudioDN effectue les étapes d’upload individuelles
Backend
Backend requis
  1. 1 Conserver une API Access key sur votre serveur
  2. 2 Autoriser l’uploader dans votre application
  3. 3 Créer une upload session à courte durée de vie
  4. 4 Passer l’ID de session au composant web AudioDN Uploader ou (voice) Recorder
  5. 5 AudioDN téléverse et traite les fichiers
  • Conservez l’API Access key uniquement sur votre serveur.
  • Ne transmettez au client que l’ID de session à courte durée de vie.

Votre flux d’upload

Upload session créée côté serveur avec une interface personnalisée

Votre serveur approuve l’upload → crée une upload session → votre interface personnalisée crée un track par fichier et téléverse chaque fichier → AudioDN traite les fichiers.

Identifiant
API Access key
Où vit l’identifiant
Sur votre serveur uniquement
Qui décide si l’upload est autorisé
Votre serveur (connexions, permissions, quotas, etc.)
Qui fournit l’interface
Votre interface web ou native personnalisée
Qui effectue les étapes d’upload
Votre application effectue les étapes d’upload individuelles
Backend
Backend requis
  1. 1 Conserver une API Access key sur votre serveur
  2. 2 Autoriser l’uploader dans votre application
  3. 3 Créer une upload session à courte durée de vie
  4. 4 Créer un track pour chaque fichier
  5. 5 Téléverser chaque fichier vers son URL d’upload renvoyée
  6. 6 Attendre le traitement AudioDN
  • Conservez l’API Access key uniquement sur votre serveur.
  • Ne transmettez au client que l’ID de session à courte durée de vie.
  • Chaque fichier a besoin de son propre track et de sa propre URL d’upload. Une upload session peut autoriser de nombreux fichiers, mais chaque fichier nécessite toujours une requête par track.

Lire et accéder aux tracks

Choisissez comment l’accès est accordé, puis — si nécessaire — comment l’audio est lu. Vous pouvez combiner les méthodes (par exemple des previews signées publiques et des play sessions contrôlées pour les tracks complets).

Comment l’accès à l’audio doit-il être accordé ?
Comment l’audio doit-il être lu ?

Votre flux de lecture

Composant web AudioDN Player avec une Client-Side Player key

Une Client-Side Player key limitée vit dans la page → le composant web AudioDN Player crée et renouvelle les play sessions → AudioDN streame les variantes autorisées.

Identifiant
Client-Side Player key
Où vit l’identifiant
Dans le navigateur (limitée)
Où l’autorisation a lieu
Portée de la clé (collection, track et/ou variantes)
Backend
Aucun backend requis
Interface
Composant web AudioDN Player
Aller-retour API avant la lecture
Le player crée les sessions automatiquement — aucun appel API séparé depuis votre code
Modèle d’accès
Identifiant client limité — pas d’approbation serveur par auditeur
  1. 1 Créer une Client-Side Player key limitée
  2. 2 Ajouter le composant web AudioDN Player avec la clé, la portée et l’id
  3. 3 Le player crée et renouvelle les play sessions
  4. 4 AudioDN streame les variantes autorisées
  • Une Client-Side Player key ne peut que créer des play sessions — pas gérer tracks ni collections.
  • Les Client-Side Player keys ne peuvent pas gérer tracks ni collections.
  • Ne mettez jamais une API Access key ni un secret URL Signing dans le code navigateur ou mobile.

Votre flux de lecture

Player personnalisé avec une Client-Side Player key

Une Client-Side Player key limitée vit dans votre app → votre app crée une play session → récupère les ressources de lecture → votre player personnalisé les streame.

Identifiant
Client-Side Player key
Où vit l’identifiant
Dans le navigateur ou l’app native (limitée)
Où l’autorisation a lieu
Portée de la clé (collection, track et/ou variantes)
Backend
Aucun backend requis
Interface
Votre player web ou natif personnalisé
Aller-retour API avant la lecture
Oui — créer une play session, puis récupérer les ressources de lecture
Modèle d’accès
Identifiant client limité — pas d’approbation serveur par auditeur
  1. 1 Créer une Client-Side Player key limitée
  2. 2 Créer une play session pour un track ou une collection
  3. 3 Récupérer les URLs de variantes signées pour chaque track
  4. 4 Les lire dans votre interface média personnalisée
  • Une Client-Side Player key ne peut que créer des play sessions — pas gérer tracks ni collections.
  • Les Client-Side Player keys ne peuvent pas gérer tracks ni collections.
  • Ne mettez jamais une API Access key ni un secret URL Signing dans le code navigateur ou mobile.

Votre flux de lecture

Play session créée côté serveur avec le composant web AudioDN Player

Votre serveur vérifie l’entitlement de l’auditeur → crée une play session → la passe au composant web AudioDN Player → AudioDN streame les variantes autorisées.

Identifiant
API Access key
Où vit l’identifiant
Sur votre serveur uniquement
Où l’autorisation a lieu
Votre serveur (connexions, achats, abonnements, permissions)
Backend
Backend requis
Interface
Composant web AudioDN Player
Aller-retour API avant la lecture
Oui — votre serveur crée une play session avant la lecture
Modèle d’accès
Contrôle d’entitlement par auditeur
  1. 1 Conserver une API Access key sur votre serveur
  2. 2 Autoriser l’auditeur dans votre application
  3. 3 Créer une play session à courte durée de vie
  4. 4 Passer l’ID de session au composant web AudioDN Player
  5. 5 AudioDN streame les variantes autorisées
  • Conservez l’API Access key uniquement sur votre serveur.
  • Vérifiez les connexions, achats, abonnements ou permissions sur votre serveur avant de créer une play session.
  • Ne transmettez au client que l’ID de session à courte durée de vie.

Votre flux de lecture

Play session créée côté serveur avec un player personnalisé

Votre serveur vérifie l’entitlement de l’auditeur → crée une play session → renvoie les ressources de lecture → votre player personnalisé les streame.

Identifiant
API Access key
Où vit l’identifiant
Sur votre serveur uniquement
Où l’autorisation a lieu
Votre serveur (connexions, achats, abonnements, permissions)
Backend
Backend requis
Interface
Votre player web ou natif personnalisé
Aller-retour API avant la lecture
Oui — votre serveur crée une play session avant la lecture
Modèle d’accès
Contrôle d’entitlement par auditeur
  1. 1 Conserver une API Access key sur votre serveur
  2. 2 Autoriser l’auditeur dans votre application
  3. 3 Créer une play session à courte durée de vie
  4. 4 Récupérer les URLs de variantes signées
  5. 5 Les lire dans votre interface média personnalisée
  • Conservez l’API Access key uniquement sur votre serveur.
  • Vérifiez les connexions, achats, abonnements ou permissions sur votre serveur avant de créer une play session.
  • Ne transmettez au client que l’ID de session à courte durée de vie.

Votre flux de lecture

Livraison signée sans play session

Votre serveur signe une URL de livraison avec une URL Signing key → renvoie l’URL temporaire → votre interface média la streame directement. Aucune play session n’est créée.

Identifiant
URL Signing key
Où vit l’identifiant
Sur votre serveur uniquement
Où l’autorisation a lieu
Votre serveur décide qui reçoit une URL signée ; posséder l’URL accorde l’accès jusqu’à son expiration
Backend
Backend requis (pour signer les URLs)
Interface
Votre propre interface média (pas le composant web AudioDN Player)
Aller-retour API avant la lecture
Pas d’aller-retour API AudioDN au moment de la lecture — signez localement et streamez depuis votre domaine de livraison
Modèle d’accès
Possession d’une URL temporaire — pas de contrôle d’entitlement par auditeur
  1. 1 Créer une URL Signing key dans le dashboard
  2. 2 Conserver le secret de signature sur votre serveur
  3. 3 Signer l’URL de livraison (HMAC-SHA256)
  4. 4 Renvoyer l’URL finale au client
  5. 5 La lire dans toute interface média qui accepte une URL
  • Le secret URL Signing ne doit jamais atteindre le navigateur. Signez côté serveur et renvoyez uniquement l’URL finale.
  • Quiconque dispose d’une URL signée valide peut streamer jusqu’à son expiration. Ce n’est pas un contrôle d’entitlement par auditeur.
  • Les URLs de livraison signée sont destinées à votre propre interface média — pas au composant web AudioDN Player.
  • La livraison signée est une option de lecture, pas une méthode d’upload. Vous avez toujours besoin d’un flux d’upload pour ingérer l’audio.

De l’envoi à la lecture, pris en charge.

Envoyer

Votre app envoie l’audio source.

Traiter

AudioDN génère les sorties configurées.

Diffuser

Votre produit reçoit les ressources nécessaires à la lecture et aux téléchargements.

Utilisez des webhooks ou le statut des pistes pour savoir quand l’audio est prêt.

Prêt pour les détails techniques ?

Ouvrez le guide correspondant pour les étapes exactes, identifiants et exemples de code.

Apportez votre propre interface. Gardez notre infrastructure.

AudioDN ne vous impose pas un lecteur, un framework ou une architecture applicative particuliers. Utilisez uniquement les services et composants dont vous avez besoin.