Téléverser des pistes

Choisissez qui crée ou autorise la session de téléversement, puis — si votre serveur la crée — comment les fichiers sont transférés. La lecture est une décision distincte ; voir Lire et accéder aux pistes.

Cycle de vie du téléversement par fichier

Une session de téléversement peut autoriser de nombreux fichiers, mais chaque fichier a besoin de sa propre piste et URL de téléversement. Créez la session, puis pour chaque fichier appelez POST /v1/upload/{upload_session_id}/track et envoyez les octets en PUT vers track_upload.upload_url. Incluez éventuellement un track imbriqué à la création de session pour le premier fichier. Référence complète : Upload Sessions.

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.

Qui doit créer ou autoriser l’upload session ?

Composants web AudioDN Uploader ou (voice) Recorder Configuration la plus rapide. Composants web avec une Client-Side Upload key limitée ; ils gèrent la création de session et le transfert. Le (voice) Recorder capture depuis le microphone. Votre navigateur ou application native Une Client-Side Upload key limitée. Votre app crée l’upload session et téléverse chaque fichier vers l’URL fournie. Votre serveur Une API Access key sur votre serveur. Votre serveur applique l’autorisation spécifique à l’application et crée une upload session à courte durée de vie.

Comment l’utilisateur doit-il transférer les fichiers ?

Composants web AudioDN Uploader ou (voice) Recorder Passez l’upload session créée côté serveur au composant web AudioDN Uploader ou (voice) Recorder. Interface d’upload personnalisée navigateur ou native Utilisez les informations d’upload fournies dans votre propre UI d’upload.

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

Configuration la plus rapide. Une Client-Side Upload key à portée limitée ; le composant crée la session et téléverse chaque fichier.

Créer une Client-Side Upload key

Dans le dashboard allez à Settings → API Keys et créez une clé Client-Side Upload. Limitez-la éventuellement à une collection. Cette clé ne peut créer que des sessions de téléversement — pas lire ni supprimer des pistes.

Installer le composant web

npm install @audiodn/components

Uploader :

import '@audiodn/components/uploader'

Ou (voice) Recorder :

import '@audiodn/components/recorder'

Alternatives CDN :

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/uploader.js"></script>

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/recorder.js"></script>

Afficher le composant web

<audiodn-uploader
  api-key="CLIENT-SIDE-UPLOAD-KEY"
  collection-id="COLLECTION-ID"
  accent-color="#ff00ff"
></audiodn-uploader>

<audiodn-recorder
  api-key="CLIENT-SIDE-UPLOAD-KEY"
  collection-id="COLLECTION-ID"
  accent-color="#ff00ff"
></audiodn-recorder>

Si la clé est limitée à une collection, vous pouvez omettre collection-id. Ne définissez jamais à la fois api-key et upload-session-id.

Ce que fait le composant web

Pour chaque fichier, le composant crée (ou réutilise) une session de téléversement, appelle POST /v1/upload/:upload_session_id/track, et téléverse les octets vers track_upload.upload_url. AudioDN traite ensuite vos variantes configurées.

Optionnel : configurez un webhook track-processing pour savoir quand une piste est prête.

Téléversement client personnalisé avec une Client-Side Upload key

Votre navigateur ou application native crée la session de téléversement et téléverse chaque fichier. Vous construisez l'interface.

Créer une Client-Side Upload key

Créez une clé Client-Side Upload à portée limitée dans le dashboard. Peut être intégrée en toute sécurité dans l’app. N’utilisez jamais une API Access key dans le code client.

Créer une session de téléversement

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer CLIENT-SIDE-UPLOAD-KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ collection_id: 'COLLECTION-ID', expires_in: 3600 })
});
const { upload_session_id } = await response.json();

var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/upload_session")!)
request.httpMethod = "POST"
request.setValue("Bearer CLIENT-SIDE-UPLOAD-KEY", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(["collection_id": "COLLECTION-ID", "expires_in": 3600])
let (data, _) = try await URLSession.shared.data(for: request)
// Decode upload_session_id from data

val body = """{"collection_id":"COLLECTION-ID","expires_in":3600}"""
  .toRequestBody("application/json".toMediaType())
val request = Request.Builder()
  .url("https://api.audiodelivery.net/v1/upload_session")
  .post(body)
  .addHeader("Authorization", "Bearer CLIENT-SIDE-UPLOAD-KEY")
  .build()
val response = client.newCall(request).execute()
// Parse upload_session_id from response body

final response = await http.post(
  Uri.parse('https://api.audiodelivery.net/v1/upload_session'),
  headers: {
    'Authorization': 'Bearer CLIENT-SIDE-UPLOAD-KEY',
    'Content-Type': 'application/json',
  },
  body: jsonEncode({'collection_id': 'COLLECTION-ID', 'expires_in': 3600}),
);
final json = jsonDecode(response.body) as Map<String, dynamic>;
final uploadSessionId = json['upload_session_id'] as String;

Créer une piste pour chaque fichier

const response = await fetch(
  `https://api.audiodelivery.net/v1/upload/${upload_session_id}/track`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ file_name: 'song.wav' })
  }
);
const { track_id, track_upload } = await response.json();
const { method, upload_url } = track_upload;

var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/upload/\(sessionId)/track")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(["file_name": "recording.m4a"])
let (data, _) = try await URLSession.shared.data(for: request)
// Decode track_upload.upload_url and method

val body = """{"file_name":"recording.m4a"}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
  .url("https://api.audiodelivery.net/v1/upload/$uploadSessionId/track")
  .post(body)
  .build()
val response = client.newCall(request).execute()
// Parse track_upload.upload_url

final response = await http.post(
  Uri.parse('https://api.audiodelivery.net/v1/upload/$uploadSessionId/track'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({'file_name': 'recording.m4a'}),
);
final trackUpload = (jsonDecode(response.body) as Map)['track_upload'] as Map;
final uploadUrl = trackUpload['upload_url'] as String;

Vous pouvez aussi inclure un objet track imbriqué à la création de session pour le premier fichier, puis utiliser cette étape pour les fichiers supplémentaires. L’URL de téléversement est dans track_upload.upload_url (pas sur l’objet track).

Téléverser les octets

await fetch(upload_url, {
  method,
  headers: { 'Content-Type': file.type },
  body: file
});

var request = URLRequest(url: uploadURL)
request.httpMethod = method
request.setValue("audio/mp4", forHTTPHeaderField: "Content-Type")
request.httpBodyStream = InputStream(url: fileURL)
let (_, response) = try await URLSession.shared.data(for: request)
print((response as! HTTPURLResponse).statusCode) // 200 on success

val fileBody = File(filePath).asRequestBody("audio/mp4".toMediaType())
val request = Request.Builder()
  .url(uploadUrl)
  .put(fileBody)
  .addHeader("Content-Type", "audio/mp4")
  .build()
client.newCall(request).execute().code

final response = await http.put(
  Uri.parse(uploadUrl),
  headers: {'Content-Type': 'audio/mp4'},
  body: await File(filePath).readAsBytes(),
);

Attendre le traitement

Interrogez GET /v1/track/{track_id} jusqu’à ce que track.track_status_id soit ready (nécessite une API Access key ou le dashboard), ou utilisez un webhook. Les Client-Side Upload keys ne peuvent pas lire l’état d’une piste — préférez les webhooks ou un sondage serveur pour la disponibilité.

Session de téléversement créée côté serveur avec l'AudioDN Uploader ou (voice) Recorder (composants web)

Votre serveur autorise le téléversement, crée une session de courte durée et la passe au composant.

Conservez une API Access key sur votre serveur

Créez une clé API Access dans le dashboard. Ne l’envoyez jamais au navigateur ou à l’application mobile.

Autoriser, puis créer une session de téléversement

Appliquez vos propres contrôles (connexion, quota, permissions), puis :

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_ACCESS_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    collection_id: 'COLLECTION-ID',
    expires_in: 3600
    // Optional: track: { file_name: 'song.wav' } to also create the first track
  })
});

const { upload_session_id, upload_session } = await response.json();
// Pass upload_session_id to the client (Uploader) or continue with per-track create.

Passer la session au composant web

npm install @audiodn/components

import '@audiodn/components/uploader'

<audiodn-uploader
  upload-session-id="UPLOAD-SESSION-ID"
  accent-color="#ff00ff"
></audiodn-uploader>

<audiodn-recorder
  upload-session-id="UPLOAD-SESSION-ID"
  accent-color="#ff00ff"
></audiodn-recorder>

Utilisez uniquement upload-session-id — ne définissez pas aussi api-key.

Le composant téléverse

L’Uploader ou le (voice) Recorder (composant web) effectue pour vous la création par piste et le téléversement des octets. Optionnel : webhook pour la disponibilité.

Session de téléversement créée côté serveur avec une interface personnalisée

Votre serveur crée la session ; votre UI web ou native personnalisée crée les pistes et téléverse les fichiers.

Conservez une API Access key sur votre serveur

Créez une clé API Access. Serveur uniquement.

Créer une session de téléversement sur le serveur

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_ACCESS_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    collection_id: 'COLLECTION-ID',
    expires_in: 3600
    // Optional: track: { file_name: 'song.wav' } to also create the first track
  })
});

const { upload_session_id, upload_session } = await response.json();
// Pass upload_session_id to the client (Uploader) or continue with per-track create.

Renvoyez upload_session_id au client. Ne renvoyez pas l’API Access key.

Créer une piste pour chaque fichier (client ou serveur)

const response = await fetch(
  `https://api.audiodelivery.net/v1/upload/${upload_session_id}/track`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ file_name: 'song.wav' })
  }
);
const { track_id, track_upload } = await response.json();
const { method, upload_url } = track_upload;

var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/upload/\(sessionId)/track")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(["file_name": "recording.m4a"])
let (data, _) = try await URLSession.shared.data(for: request)
// Decode track_upload.upload_url and method

val body = """{"file_name":"recording.m4a"}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
  .url("https://api.audiodelivery.net/v1/upload/$uploadSessionId/track")
  .post(body)
  .build()
val response = client.newCall(request).execute()
// Parse track_upload.upload_url

final response = await http.post(
  Uri.parse('https://api.audiodelivery.net/v1/upload/$uploadSessionId/track'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({'file_name': 'recording.m4a'}),
);
final trackUpload = (jsonDecode(response.body) as Map)['track_upload'] as Map;
final uploadUrl = trackUpload['upload_url'] as String;

Téléverser les octets

await fetch(upload_url, {
  method,
  headers: { 'Content-Type': file.type },
  body: file
});

var request = URLRequest(url: uploadURL)
request.httpMethod = method
request.setValue("audio/mp4", forHTTPHeaderField: "Content-Type")
request.httpBodyStream = InputStream(url: fileURL)
let (_, response) = try await URLSession.shared.data(for: request)
print((response as! HTTPURLResponse).statusCode) // 200 on success

val fileBody = File(filePath).asRequestBody("audio/mp4".toMediaType())
val request = Request.Builder()
  .url(uploadUrl)
  .put(fileBody)
  .addHeader("Content-Type", "audio/mp4")
  .build()
client.newCall(request).execute().code

final response = await http.put(
  Uri.parse(uploadUrl),
  headers: {'Content-Type': 'audio/mp4'},
  body: await File(filePath).readAsBytes(),
);

Attendre que ce soit prêt

// Processing starts automatically. Poll until ready, or use a webhook.
let track;
do {
  await new Promise((r) => setTimeout(r, 5000));
  const res = await fetch(`https://api.audiodelivery.net/v1/track/${track_id}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_ACCESS_KEY' }
  });
  ({ track } = await res.json());
} while (track.track_status_id !== 'ready');

Ou utilisez le webhook track-processing au lieu de sonder.

Téléverser des pistes

Cycle de vie du téléversement par fichier

Téléverser des tracks

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

Créer une Client-Side Upload key

Installer le composant web

Afficher le composant web

Ce que fait le composant web

Téléversement client personnalisé avec une Client-Side Upload key

Créer une Client-Side Upload key

Créer une session de téléversement

Créer une piste pour chaque fichier

Téléverser les octets

Attendre le traitement

Session de téléversement créée côté serveur avec l'AudioDN Uploader ou (voice) Recorder (composants web)

Conservez une API Access key sur votre serveur

Autoriser, puis créer une session de téléversement

Passer la session au composant web

Le composant téléverse

Session de téléversement créée côté serveur avec une interface personnalisée

Conservez une API Access key sur votre serveur

Créer une session de téléversement sur le serveur

Créer une piste pour chaque fichier (client ou serveur)

Téléverser les octets

Attendre que ce soit prêt

Références associées