Autenticazione

Tutte le richieste API devono essere autenticate utilizzando una chiave API.

URL di base

https://api.recordmeeting.com/v1

Autenticazione con chiave API

Includi la tua chiave API nell’header Authorization:

Authorization: Bearer <your_api_key>

Per creare una chiave API, consulta Guida utente → Chiavi API.

Esempio di richiesta

curl -X GET "https://api.recordmeeting.com/v1/recordings"
  -H "Authorization: Bearer rm_your_api_key_here"

Risposte di errore

Tutti gli errori seguono questo formato:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable description"
  }
}

Codici di errore di autenticazione

Codice	Stato HTTP	Significato
UNAUTHORIZED	401	Header Authorization mancante o malformato
INVALID_API_KEY	401	La chiave non esiste o è stata revocata
API_KEY_EXPIRED	401	La chiave è scaduta
USER_NOT_FOUND	401	L’utente associato alla chiave non esiste più
FORBIDDEN	403	Autenticato, ma senza permesso per questa risorsa

Codici di errore comuni

Codice	Stato HTTP	Significato
RECORDING_NOT_FOUND	404	L’ID della registrazione non esiste o non è accessibile
RECORDING_LOCKED	403	La funzionalità richiede un aggiornamento dell’abbonamento
ORGANIZATION_SUBSCRIPTION_EXPIRED	402	L’organizzazione proprietaria della registrazione non ha più un abbonamento Enterprise attivo
TRANSCRIPT_NOT_AVAILABLE	403	La trascrizione è disabilitata per l’organizzazione o per il membro
SHARING_DISABLED	403	La condivisione è disabilitata per l’organizzazione o per il membro
VALIDATION_ERROR	400	Parametri di richiesta non validi o mancanti
INTERNAL_ERROR	500	Errore lato server