Registrazioni
Endpoint per registrazioni, trascrizioni e link di condivisione. Tutti i percorsi sono su https://api.recordmeeting.com e richiedono una chiave API. Vedi Autenticazione.
Elenca le registrazioni
Sezione intitolata “Elenca le registrazioni”GET /v1/recordingsRestituisce un elenco paginato delle registrazioni a cui hai accesso.
Parametri di query
Sezione intitolata “Parametri di query”| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
limit | integer | 20 | Numero di risultati (da 1 a 100) |
offset | integer | 0 | Offset di paginazione |
search | string | nessuno | Filtra per testo nel titolo |
status | string | nessuno | Filtra per stato (vedi Stati delle registrazioni) |
date_from | string | nessuno | Data e ora ISO 8601. Solo le registrazioni create in questa data/ora o dopo |
date_to | string | nessuno | Data e ora ISO 8601. Solo le registrazioni create in questa data/ora o prima |
organization_id | string | nessuno | Elenca le registrazioni di un’organizzazione |
folder_id | string | nessuno | Elenca le registrazioni di una cartella |
user_id | string | nessuno | Filtra per utente. Per gli amministratori dell’organizzazione che vogliono le registrazioni di un membro |
Risposta
Sezione intitolata “Risposta”{ "data": [ { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "folder_id": null, "organization_id": null, "transcription_status": "completed", "notes_status": "completed", "is_shared": true, "processing_progress": null } ], "pagination": { "total": 42, "limit": 20, "offset": 0, "has_more": true }}title, duration_seconds, thumbnail_url, folder_id, organization_id, transcription_status, notes_status e processing_progress possono essere null. Per una registrazione bloccata, transcription_status e notes_status sono null.
Con organization_id, Editori e Visualizzatori ricevono solo le registrazioni che sono autorizzati a vedere. total è quindi un limite massimo e una pagina può contenere meno di limit elementi.
Errori: 400 VALIDATION_ERROR, 403 FORBIDDEN quando non puoi elencare le registrazioni di quell’organizzazione.
Ottieni registrazione
Sezione intitolata “Ottieni registrazione”GET /v1/recordings/:idRestituisce tutti i dettagli di una registrazione.
Una registrazione dell’organizzazione viene restituita a qualsiasi membro che possa visualizzarla. Proprietari e Amministratori possono aprire ogni registrazione della loro organizzazione. Editori e Visualizzatori vedono ciò che il loro ruolo e le cartelle consentono. Per una registrazione dell’organizzazione, is_locked, download_url e capabilities seguono il piano dell’organizzazione e l’accesso alle funzionalità del membro, non il tuo piano personale.
Risposta
Sezione intitolata “Risposta”{ "data": { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "updated_at": "2026-09-19T15:30:00.000Z", "started_at": "2026-09-19T15:01:00.000Z", "ended_at": "2026-09-19T15:30:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "download_url": "https://...", "download_url_expires_at": "2026-09-19T21:30:00.000Z", "folder_id": null, "organization_id": null, "processing_progress": null, "transcription": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "segments_count": 184 }, "notes": "## Key topics\n...", "notes_status": "completed", "notes_truncated": false, "sharing": { "is_shared": true, "share_url": "https://recordmeeting.com/app/shared/abc123" }, "participants": [ { "id": "participant_id", "displayName": "Alice", "email": "alice@example.com", "source": "calendar", "isOrganizer": true, "mappedSpeaker": "Alice", "avatarUrl": null } ], "media_type": "video", "is_locked": false, "open_url": "https://recordmeeting.com/app/recording/uuid", "media": { "hls_url": "https://...", "direct_url": "https://...", "expires_at": "2026-09-19T21:30:00.000Z" }, "capabilities": { "canDownload": true, "canShare": true, "canViewTranscription": true, "canStartTranscription": true, "canRegenerateTranscription": false, "canRenameSpeaker": true, "canReplaceText": true, "canViewSummary": true, "canGenerateSummary": true, "canAskQuestions": true, "canGenerateArtifacts": true } }}Campi da conoscere
Sezione intitolata “Campi da conoscere”| Campo | Descrizione |
|---|---|
notes | Le note della riunione in Markdown. null quando non ce ne sono o la registrazione è bloccata |
download_url | Un link temporaneo per il download. null a meno che capabilities.canDownload non sia true. Scade all’orario indicato in download_url_expires_at |
media | Link temporanei per la riproduzione. Richiedi di nuovo la registrazione una volta superato expires_at |
media_type | video o audio |
is_locked | true quando la registrazione è bloccata. transcription e notes sono quindi null |
open_url | La pagina della registrazione nell’app web |
sharing.share_url | Il link di condivisione della registrazione, oppure null quando non ne ha uno |
Errori: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED quando l’abbonamento Enterprise dell’organizzazione non è più attivo.
Ottieni trascrizione
Sezione intitolata “Ottieni trascrizione”GET /v1/recordings/:id/transcriptRestituisce la trascrizione di una registrazione come segmenti, in pagine di blocchi.
Le registrazioni dell’organizzazione seguono le stesse regole di accesso di Ottieni registrazione. Una registrazione che non ha ancora una trascrizione restituisce comunque 200, con "status": "not_started" e un array segments vuoto.
Parametri di query
Sezione intitolata “Parametri di query”| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
start_chunk | integer | 0 | Indice del primo blocco da restituire |
limit | integer | 50 | Numero di blocchi (da 1 a 100) |
Risposta
Sezione intitolata “Risposta”{ "data": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "duration": 1740.5, "segments": [ { "id": 1, "start": 0.5, "end": 3.2, "text": "Good morning everyone.", "speaker": "Alice", "confidence": 0.97 } ], "pagination": { "total_chunks": 4, "has_more": true } }}start e end sono espressi in secondi. speaker e confidence possono essere null. Finché has_more è true, richiedi la pagina successiva con un valore di start_chunk più alto.
Errori: 403 RECORDING_LOCKED per una registrazione bloccata, 403 TRANSCRIPT_NOT_AVAILABLE quando la trascrizione è disattivata per l’organizzazione o il membro, 403 SUBSCRIPTION_REQUIRED quando la trascrizione completa richiede un piano a pagamento, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Aggiorna registrazione
Sezione intitolata “Aggiorna registrazione”PATCH /v1/recordings/:idRinomina una registrazione, sostituisce le sue note della riunione o entrambe le cose. È richiesto almeno un campo.
Corpo della richiesta
Sezione intitolata “Corpo della richiesta”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Campo | Descrizione |
|---|---|
title | Da 1 a 500 caratteri |
notes | Note della riunione in Markdown, fino a 100.000 caratteri. Sostituisce le note esistenti |
Risposta
Sezione intitolata “Risposta”204 No Content con un corpo vuoto.
Errori: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Elimina registrazione
Sezione intitolata “Elimina registrazione”DELETE /v1/recordings/:idElimina definitivamente una registrazione e tutti i suoi dati: la trascrizione, le note e i link di condivisione.
Risposta
Sezione intitolata “Risposta”204 No Content con un corpo vuoto.
Errori: 404 RECORDING_NOT_FOUND.
Crea link di condivisione
Sezione intitolata “Crea link di condivisione”POST /v1/recordings/:id/share-linkCrea il link di condivisione pubblico di una registrazione o sostituisce quello esistente. Il link precedente smette di funzionare.
Per una registrazione dell’organizzazione, qualsiasi membro che può visualizzare la registrazione può creare il link. Viene creato per conto del proprietario della registrazione e usa il piano dell’organizzazione.
Corpo della richiesta
Sezione intitolata “Corpo della richiesta”{ "permission": "view"}| Valore | Descrizione |
|---|---|
view | Le persone con il link possono guardare la registrazione |
download | Le persone con il link possono anche scaricarla |
Risposta
Sezione intitolata “Risposta”{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}Errori: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY quando la registrazione non può ancora essere condivisa, 403 RECORDING_LOCKED, 403 SHARING_DISABLED quando la condivisione è disattivata per l’organizzazione o il membro, 403 SUBSCRIPTION_REQUIRED quando il permesso richiede un piano a pagamento, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Stati delle registrazioni
Sezione intitolata “Stati delle registrazioni”| Stato | Descrizione |
|---|---|
STARTING | La registrazione è in fase di configurazione |
CONNECTING | Connessione alla riunione |
WAIT_APPROVAL | In attesa dell’approvazione per registrare |
RECORDING | La registrazione è in corso |
STALE | La registrazione ha smesso di inviare dati prima di essere completata |
UPLOADING | La registrazione è terminata ed è ancora in fase di caricamento |
PROCESSING | Il video è in fase di elaborazione e non può ancora essere riprodotto |
MIGRATING | Il video può essere riprodotto mentre viene spostato nell’archivio a lungo termine |
COMPLETED | La registrazione è completamente elaborata |
ERROR | La registrazione non è riuscita |