Salta ai contenuti

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.

GET /v1/recordings

Restituisce un elenco paginato delle registrazioni a cui hai accesso.

ParametroTipoPredefinitoDescrizione
limitinteger20Numero di risultati (da 1 a 100)
offsetinteger0Offset di paginazione
searchstringnessunoFiltra per testo nel titolo
statusstringnessunoFiltra per stato (vedi Stati delle registrazioni)
date_fromstringnessunoData e ora ISO 8601. Solo le registrazioni create in questa data/ora o dopo
date_tostringnessunoData e ora ISO 8601. Solo le registrazioni create in questa data/ora o prima
organization_idstringnessunoElenca le registrazioni di un’organizzazione
folder_idstringnessunoElenca le registrazioni di una cartella
user_idstringnessunoFiltra per utente. Per gli amministratori dell’organizzazione che vogliono le registrazioni di un membro
{
"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.


GET /v1/recordings/:id

Restituisce 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.

{
"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
}
}
}
CampoDescrizione
notesLe note della riunione in Markdown. null quando non ce ne sono o la registrazione è bloccata
download_urlUn link temporaneo per il download. null a meno che capabilities.canDownload non sia true. Scade all’orario indicato in download_url_expires_at
mediaLink temporanei per la riproduzione. Richiedi di nuovo la registrazione una volta superato expires_at
media_typevideo o audio
is_lockedtrue quando la registrazione è bloccata. transcription e notes sono quindi null
open_urlLa pagina della registrazione nell’app web
sharing.share_urlIl 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.


GET /v1/recordings/:id/transcript

Restituisce 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.

ParametroTipoPredefinitoDescrizione
start_chunkinteger0Indice del primo blocco da restituire
limitinteger50Numero di blocchi (da 1 a 100)
{
"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.


PATCH /v1/recordings/:id

Rinomina una registrazione, sostituisce le sue note della riunione o entrambe le cose. È richiesto almeno un campo.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
CampoDescrizione
titleDa 1 a 500 caratteri
notesNote della riunione in Markdown, fino a 100.000 caratteri. Sostituisce le note esistenti

204 No Content con un corpo vuoto.

Errori: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Elimina definitivamente una registrazione e tutti i suoi dati: la trascrizione, le note e i link di condivisione.

204 No Content con un corpo vuoto.

Errori: 404 RECORDING_NOT_FOUND.


POST /v1/recordings/:id/share-link

Crea 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.

{
"permission": "view"
}
ValoreDescrizione
viewLe persone con il link possono guardare la registrazione
downloadLe persone con il link possono anche scaricarla
{
"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.


StatoDescrizione
STARTINGLa registrazione è in fase di configurazione
CONNECTINGConnessione alla riunione
WAIT_APPROVALIn attesa dell’approvazione per registrare
RECORDINGLa registrazione è in corso
STALELa registrazione ha smesso di inviare dati prima di essere completata
UPLOADINGLa registrazione è terminata ed è ancora in fase di caricamento
PROCESSINGIl video è in fase di elaborazione e non può ancora essere riprodotto
MIGRATINGIl video può essere riprodotto mentre viene spostato nell’archivio a lungo termine
COMPLETEDLa registrazione è completamente elaborata
ERRORLa registrazione non è riuscita