RTC : apportez votre propre stockage
RTC peut copier chaque enregistrement terminé dans un compartiment dont vous êtes propriétaire. CHAMPREP Il conserve également sa propre copie, de sorte que l’enregistrement reste téléchargeable depuis RTC, que la diffusion aboutisse ou non.
Plans qui l’incluent
Section intitulée « Plans qui l’incluent »La livraison vers votre propre espace de stockage est incluse dans le Croissance et Entreprise
niveaux. L’essai gratuit, le niveau Starter et le quota inclus dans les formules payantes CHAMPREP ne l’incluent pas. Sans cela, les routes de stockage répondent 403
RTC_FEATURE_NOT_IN_PLAN avec les niveaux qui l’incluent dans offers. Voir plans et facturation.
Si votre forfait cesse de l’inclure, RTC désactive vos destinations. Après avoir effectué une nouvelle mise à niveau, réactivez-les une à une ; RTC effectue d’abord un nouveau test d’écriture.
Choisissez un type de destination
Section intitulée « Choisissez un type de destination »| Type | Utilisez-le pour | Ce que RTC conserve |
|---|---|---|
aws-role (de préférence) | Un compartiment AWS S3 | Rien de confidentiel. RTC suppose que vous créez un rôle IAM, doté d’un identifiant externe. |
s3-compatible | Cloudflare R2, MinIO, Wasabi, Backblaze B2 ou AWS avec des clés d’accès | Votre ID de clé d’accès et votre clé secrète, chiffrés |
Une destination appartient à votre organisation. Elle dessert un projet, ou tous les projets lorsque projectId est null. Une organisation peut avoir jusqu’à 5 destinations ; une réponse supplémentaire 409
DESTINATION_LIMIT.
Gérer les destinations
Section intitulée « Gérer les destinations »Créez, modifiez, testez et supprimez des destinations dans la console RTC, ou via l’API avecAPI votre session de console connectée. API Les clés ne peuvent ni créer ni modifier de destinations. Une clé disposant de recordings:read peut les répertorier ; une clé de projet voit les destinations de son projet et celles de tous les projets.
| Méthode et chemin d’accès | Identifiant | Résultat |
|---|---|---|
GET /v1/storage/destinations | Session de la console, ou une clé avec recordings:read | Les destinations, classées par ordre chronologique décroissant |
GET /v1/storage/destinations/{destinationId} | Session de la console, ou une clé avec recordings:read | Une destination |
GET /v1/storage/aws-setup | Session de la console | Votre identifiant externe et les politiques IAM à coller (Rôle AWS) |
POST /v1/storage/destinations | Session de la console | 201, la destination après son test d’écriture |
PATCH /v1/storage/destinations/{destinationId} | Session de la console | Modifiez les paramètres, effectuez la rotation des clés ou activez/désactivez le rôle |
POST /v1/storage/destinations/{destinationId}/test | Session de la console | Relancez l’écriture de test |
DELETE /v1/storage/destinations/{destinationId} | Session de la console | { "id": "…", "deleted": true } |
GET /v1/recordings/{recordingId}/deliveries | recordings:read | Les livraisons de l’enregistrement (Suivez les livraisons) |
POST /v1/recordings/{recordingId}/redeliver | recordings:write | 202, renvoie l’enregistrement |
DELETE /v1/recordings/{recordingId} | recordings:write | Envoie l’enregistrement dans la corbeille (Supprimer un enregistrement) |
GET /v1/recordings?trashed=true | recordings:read | Les enregistrements dans la corbeille |
POST /v1/recordings/{recordingId}/restore | recordings:write | Récupère l’enregistrement de la corbeille |
POST /v1/recordings/{recordingId}/purge | recordings:write | Supprime définitivement l’enregistrement de la corbeille |
Les identifiants ne sont jamais renvoyés. Les réponses sont envoyées avec
Cache-Control: no-store.
| Champ | Les deux types | Notes |
|---|---|---|
type | ✓ | aws-role ou s3-compatible |
name | ✓ | Votre libellé, jusqu’à 80 caractères |
projectId | ✓ | Un projet, ou null pour chaque projet |
bucket, region | ✓ | Le nom du compartiment et sa région |
pathTemplate | ✓ | Facultatif ; voir Modèles de chemin d’accès |
keepCopyDays | ✓ | Facultatif, de 0 à 3 650, valeur par défaut 7 ; voir rétention |
roleArn, kmsKeyId | aws-role | Votre rôle, et éventuellement votre clé KMS pour SSE-KMS |
provider, endpoint, forcePathStyle, accessKeyId, secretAccessKey | s3-compatible | forcePathStyle La valeur par défaut est true |
Une destination signale également son status (active, unverified ou
disabled), lastCheck (la dernière écriture de test) et lastDelivery.
AWS S3 avec un rôle IAM
Section intitulée « AWS S3 avec un rôle IAM »RTC ne conserve jamais vos clés AWS. Vous créez un rôle dans votre compte que le rôle de livraison de RTC peut endosser, limité par un identifiant externe unique à votre organisation.
- Appelez
GET /v1/storage/aws-setup?bucket=<your-bucket>(ajoutezpathTemplateetkmsKeyArn(si vous les utilisez), ou ouvrez la même configuration dans la console. - Créez un rôle IAM. Collez le code renvoyé
trustPolicy: il ne fait confiance qu’àprincipalArnuniquement lorsque la requête comporte votreexternalId. - Associez le qui vous a été fourni
permissionsPolicy. Il autorises3:PutObjectets3:AbortMultipartUploadsous votre chemin d’accès,s3:DeleteObjectuniquement sur le dossier de validation, etkms:GenerateDataKeyetkms:Encryptsur votre clé KMS alors que vous en aviez fourni une. - Créez la destination avec
type: "aws-role"et le rôleroleArn:
{ "type": "aws-role", "name": "Recordings archive", "projectId": null, "bucket": "acme-rtc-recordings", "region": "us-east-1", "roleArn": "<your-delivery-role-arn>"}L’identifiant externe est créé une seule fois pour votre organisation et ne change pas. Lorsque available est false Dans la réponse de configuration, les destinations de rôle AWS ne sont pas encore disponibles et la création d’une destination donne la réponse suivante 503
DELIVERY_NOT_CONFIGURED; utilisez les clés d’accès en attendant.
Stockage compatible S3 avec clés
Section intitulée « Stockage compatible S3 avec clés »Utilisation type: "s3-compatible" pour Cloudflare R2, MinIO, Wasabi, Backblaze B2 ou AWS lorsque vous préférez utiliser des clés d’accès. Indiquez le nom de votre service dans le provider champ, avec l’une des valeurs suivantes : r2, minio, wasabi, backblaze, aws ou other.
endpointdoit s’agir d’une origine HTTPS sur le port 443, sans chemin d’accès, requête ni nom d’utilisateur, en dehors des domainesCHAMPREP, et doit résoudre vers des adresses publiques. RTC vérifie à nouveau l’adresse à chaque connexion. Sinon, RTC répond400ENDPOINT_NOT_ALLOWED.- Accordez aux clés un accès en écriture au compartiment. Supprimez l’accès au
champrep-rtc-validation/Le dossier permet à RTC de supprimer son objet de test. - Les clés sont chiffrées au repos et ne sont jamais restituées. Une destination n’affiche que
accessKeyIdHint, les quatre derniers caractères de l’ID de clé. - Pour effectuer la rotation des clés,
PATCHaccessKeyIdetsecretAccessKeyà la fois. - Lorsque le stockage des clés n’est pas disponible, RTC répond
503CREDENTIALS_UNAVAILABLE; utilisez un rôle AWS en attendant.
Test de validation d’écriture
Section intitulée « Test de validation d’écriture »RTC teste une destination lorsque vous la créez, lorsque vous modifiez sa région, son modèle de chemin d’accès, son rôle, sa clé KMS, son point de terminaison, son style de chemin d’accès ou ses clés, lorsque vous la réactivez, et lorsque vous appelez
POST /v1/storage/destinations/{destinationId}/test.
Le test écrit un objet de 64 octets vers
<path prefix>/champrep-rtc-validation/<uuid>.txt puis le supprime. Une suppression refusée n’est qu’un avertissement : autorisez s3:DeleteObject sur ce dossier, ou supprimez l’objet vous-même.
Lorsque le test échoue, la destination est enregistrée sous la forme unverified et ne reçoit rien. lastCheck contient un code et une phrase :
| Code | Signification |
|---|---|
ROLE_ASSUME_DENIED | RTC n’a pas pu assumer le rôle (politique de confiance ou identifiant externe) |
WRITE_DENIED | L’écriture a été refusée |
BUCKET_NOT_FOUND | Le compartiment n’existe pas |
WRONG_REGION | Le compartiment se trouve dans une autre région |
INVALID_ACCESS_KEY, INVALID_SECRET_KEY | Les clés ont été refusées |
KMS_DENIED | La clé KMS a refusé le chiffrement |
ENDPOINT_NOT_ALLOWED, ENDPOINT_NOT_FOUND, ENDPOINT_UNREACHABLE | Le point de terminaison est refusé, inconnu ou ne répond pas |
DELIVERY_NOT_CONFIGURED | Les destinations de rôle AWS ne sont pas encore disponibles |
STORAGE_ERROR | Une autre erreur de stockage |
Corrigez la cause du problème, puis effectuez un nouveau test. Une destination devient active lorsqu’un test réussit. Une destination désactivée par le supportCHAMPREP ne peut pas être réactivée par vous (DESTINATION_ADMIN_DISABLED).
Modèles de chemin d’accès
Section intitulée « Modèles de chemin d’accès »Le modèle définit la clé d’objet de chaque fichier. La valeur par défaut est :
{project}/{yyyy}/{mm}/{dd}/{room}/{recording_id}/{file}| Variable | Valeur |
|---|---|
{project} | Identifiant du projet |
{room} | Identifiant de la salle |
{recording_id} | Identifiant de l’enregistrement |
{external_ref} | La salle externalRef; none lorsqu’il est absent ou inhabituel |
{track_id} | Identifiant de piste |
{artifact} | Quel fichier de l’enregistrement |
{file} | <trackId>.mkv, recording.mp4, audio.m4a, ou pour un transcription transcript.json et transcript.vtt |
{yyyy}, {mm}, {dd} | Éléments de date |
Les alias project_id, projectId, room_id, roomId, recordingId,
externalRef et trackId sont également acceptés.
Un modèle doit contenir {recording_id} et se termine par {file}. Le texte littéral peut comporter des lettres, des chiffres et ! _ . * ' ( ) / -. Elle ne peut pas commencer par / ou contenir //, . ou .. dossiers. Une clé ne peut pas dépasser 900 octets.
Livraison
Section intitulée « Livraison »- Lorsqu’un enregistrement est
ready, RTC copie chacun de ses fichiers (chaque piste, ainsi que les fichiers composites le cas échéant) vers chaque destination active de son projet. Une transcription terminée transcription est transmise de la même manière quetranscript.jsonettranscript.vtt. - Seuls les enregistrements qui s’achèvent après l’activation d’une destination sont transmis automatiquement. Pour transmettre les enregistrements antérieurs, utilisez redeliver.
- Les fichiers de plus de 16 Mio sont envoyés par parties. RTC communique la valeur SHA-256 des octets qu’il a envoyés.
- En cas d’échec, une nouvelle tentative est effectuée avec un délai d’attente (1, 2, 4… minutes, avec un intervalle maximal d’une heure) pendant 72 heures. Passé ce délai, la transmission est considérée comme ayant échoué et
recording.delivery_failedest envoyée. - Les octets transférés sont pris en compte dans le quota de téléchargement de votre forfait.
- La désactivation d’une destination annule ses envois en file d’attente. Sa suppression a le même effet et supprime ses identifiants.
Un processus interrompu au milieu d’un téléchargement peut laisser des parties incomplètes dans votre compartiment. Ajoutez un AbortIncompleteMultipartUpload règle de cycle de vie (1 jour) vers le compartiment.
Webhooks
Section intitulée « Webhooks »Abonnez-vous à votre Points de terminaison des webhooks à ces événements. Chaque transfert de fichier génère son propre événement.
| Événement | data |
|---|---|
recording.delivered | recordingId, roomId, destinationId, artifact, trackId (pour une piste), bucket, key, size, sha256, checksum, etag, deliveredAt |
recording.delivery_failed | recordingId, roomId, destinationId, artifact, trackId (pour une piste), bucket, key, attempts, error (code, message) |
Suivre les envois
Section intitulée « Suivre les envois »Un enregistrement comporte un récapitulatif de livraison : delivery.state (pending,
delivered, partial ou failed) et le pending, delivered et
failed compte.
GET /v1/recordings/{recordingId}/deliveries revient recordingId, c’est-à-dire que
summary et deliveries: chaque tâche avec son compartiment cible et sa clé, son résultat (taille, SHA-256 et ETag) et sa dernière erreur.
Renvoyer
Section intitulée « Renvoyer »POST /v1/recordings/{recordingId}/redeliver avec une option facultative
{ "destinationId": "…" } relance les tâches ayant échoué, annulées ou livrées avec une nouvelle fenêtre de 72 heures et crée celles qui manquent.
| HTTP | Code | Signification |
|---|---|---|
409 | RECORDING_NOT_READY | Seul un ready L’enregistrement peut être livré |
409 | NO_ACTIVE_DESTINATION | Aucune destination active ne s’applique à cet enregistrement |
404 | NO_ACTIVE_DESTINATION | Aucune destination active ne présente cette caractéristique destinationId |
Supprimer un enregistrement
Section intitulée « Supprimer un enregistrement »La suppression d’un enregistrement l’envoie dans la corbeille. Il est supprimé automatiquement au bout de 30 jours, et vous pouvez le restaurer jusqu’à ce moment-là. Chaque appel ci-dessous nécessite une clé avec
recordings:write ou votre session de console.
Envoyer à la corbeille
Section intitulée « Envoyer à la corbeille »DELETE /v1/recordings/{recordingId} Envoie l’enregistrement dans la corbeille :
{ "id": "…", "status": "trashed", "trashedAt": "2026-11-08T12:00:00.000Z", "reason": "customer", "purgeAt": "2026-12-08T12:00:00.000Z" }- L’enregistrement quitte la liste et
GET /v1/recordings/{recordingId}.GET /v1/recordings?trashed=trueaffiche la liste des enregistrements présents dans la corbeille. - Les téléchargements cessent de fonctionner, y compris les liens de téléchargement déjà générés.
- Ses envois en file d’attente sont annulés.
- Il continue de compter dans l’espace de stockage des enregistrements et est facturé tant qu’il se trouve dans la Corbeille.
purgeAtLa suppression automatique intervient : 30 jours après son envoi dans la corbeille. Ce délai est fixé au moment où l’enregistrement est envoyé dans la corbeille : toute modification ultérieure de la fenêtre « Corbeille » ne s’applique qu’aux enregistrements envoyés dans la corbeille après cette opération.purgeAtC’estnulltandis que la suppression automatique de la corbeille est désactivée.recording.deletedest envoyé.- Un enregistrement encore en cours d’exécution ou de traitement répond
409RECORDING_ACTIVE; arrêtez-le ou attendez.
Restaurer
Section intitulée « Restaurer »POST /v1/recordings/{recordingId}/restore récupère l’enregistrement de la corbeille. La réponse correspond à l’enregistrement, qui réapparaît dans vos listes et vos téléchargements comme avant sa suppression. recording.restored est envoyé. Vous pouvez restaurer un enregistrement jusqu’à ce qu’il soit supprimé automatiquement ou définitivement. Une restauration qui intervient trop tard répond 409
RECORDING_PURGED.
Les envois vers votre propre espace de stockage qui ont été annulés lorsque l’enregistrement a été déplacé vers la Corbeille sont renvoyés. Un enregistrement restauré est conservé jusqu’à ce que vous le supprimiez à nouveau : la conservation ne le renvoie pas dans la Corbeille.
Supprimez-le définitivement
Section intitulée « Supprimez-le définitivement »POST /v1/recordings/{recordingId}/purge supprime définitivement un enregistrement de la corbeille. Le RTC l’accepte immédiatement et répond 202; la suppression s’achève rapidement :
{ "id": "…", "status": "deleting", "purgeRequestedAt": "2026-11-08T12:05:00.000Z" }- Il ne peut en aucun cas être rétabli, dès lors que RTC a accepté la requête.
- Une fois la suppression effectuée, ses fichiers sont effacés, elle ne compte plus dans le stockage des enregistrements, et
recording.purgedest envoyé. - Il est sans risque de réitérer la requête : elle renvoie
202à nouveau pendant que la suppression s’exécute, puis200une fois que c’est fait :{ "id": "…", "status": "purged", "purgedAt": "2026-11-08T12:05:30.000Z" }. - Seul un enregistrement situé dans la corbeille peut être supprimé définitivement. Tout autre enregistrement répond
409RECORDING_NOT_IN_TRASH: envoyez-le d’abord dans la corbeille.
Suppression automatique
Section intitulée « Suppression automatique »Un enregistrement est supprimé définitivement à son purgeAt (30 jours dans la corbeille), de la même manière, et recording.purged est envoyé avec reason: "expired". Le service CHAMPREP d’assistance peut également supprimer plus tôt un enregistrement se trouvant dans la corbeille, à votre demande.
Les copies déjà livrées dans votre compartiment vous appartiennent. Envoyer un enregistrement dans la Corbeille, le supprimer définitivement ou activer sa suppression automatique ne les supprime jamais.
Conservation
Section intitulée « Conservation »CHAMPREP conserve sa propre copie d’un enregistrement pendant la durée de conservation prévue par votre forfait : 7 jours pour la version d’essai, 30 jours pour le forfait Starter, 90 jours pour le forfait Growth et 365 jours pour le forfait Business. Une fois ce délai écoulé, l’enregistrement est envoyé dans la corbeille de la même manière que ci-dessus, avec reason: "retention": vous pouvez le restaurer pendant 30 jours, après quoi il est supprimé automatiquement.
La conservation ne s’applique qu’aux enregistrements effectués après que RTC a commencé à l’appliquer. Les enregistrements effectués avant cette date ne sont pas supprimés par ce mécanisme. La conservation n’affecte jamais les copies présentes dans votre propre compartiment.
keepCopyDays Sur une destination (0 à 3650, par défaut 7), ce paramètre enregistre la durée pendant laquelle vous souhaitez CHAMPREPconserver sa copie après une livraison. La copie CHAMPREPdu jour suit la durée de conservation de votre forfait ; ce paramètre ne la supprime pas plus tôt.