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’intestazione Authorization:

Authorization: Bearer <your_api_key>

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

Richiesta di esempio

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": "Descrizione leggibile dall'uomo"
  }
}

Codici di errore di autenticazione

Codice	Stato HTTP	Significato
UNAUTHORIZED	401	Intestazione Authorization mancante o malformata
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 funzione richiede un aggiornamento dell’abbonamento
VALIDATION_ERROR	400	Parametri della richiesta non validi o mancanti
INTERNAL_ERROR	500	Errore lato server