Salta ai contenuti

Autenticazione

Ogni richiesta all’API di Record Meeting richiede una chiave API. Crei le chiavi nell’app in Impostazioni ➤ Chiavi API.

La scheda Chiavi API di Impostazioni con il pulsante Crea chiave

https://api.recordmeeting.com/v1

I percorsi degli endpoint in questa documentazione sono scritti con il prefisso /v1, ad esempio GET /v1/recordings. Aggiungili a https://api.recordmeeting.com.

Invia la tua chiave API nell’header Authorization. Le chiavi iniziano con sk_rm_.

Authorization: Bearer sk_rm_your_key

Per creare una chiave, vedi Guida utente ➤ Chiavi API. Una chiave ha lo stesso accesso del tuo account: le tue registrazioni e le registrazioni dell’organizzazione che ti è consentito vedere.

Terminal window
curl "https://api.recordmeeting.com/v1/recordings" \
-H "Authorization: Bearer sk_rm_your_key"

Le risposte riuscite sono JSON con il risultato sotto data. Gli endpoint di elenco che paginano i risultati aggiungono un oggetto pagination. Alcune risposte includono anche "success": true.

Le richieste PATCH e DELETE rispondono con 204 No Content e un corpo vuoto quando vanno a buon fine.

Tutti gli errori hanno questo formato:

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

Una richiesta senza un header Authorization valido riceve 401.

CodiceStato HTTPSignificato
INVALID_API_KEY401La chiave non esiste o è stata revocata
API_KEY_EXPIRED401La chiave è scaduta
USER_NOT_FOUND401L’account a cui appartiene la chiave non esiste più
AUTH_ERROR401Autenticazione non riuscita
CodiceStato HTTPSignificato
VALIDATION_ERROR400Parametri della richiesta non validi o mancanti
RECORDING_NOT_READY400La registrazione non può ancora essere condivisa
ORGANIZATION_SUBSCRIPTION_EXPIRED402L’organizzazione proprietaria della registrazione non ha più un abbonamento Enterprise attivo
FORBIDDEN403Non sei un membro dell’organizzazione o non hai il permesso di vedere ciò che hai richiesto
RECORDING_LOCKED403La registrazione è bloccata. Esegui l’upgrade per aprirla
SUBSCRIPTION_REQUIRED403L’azione richiede un piano a pagamento
TRANSCRIPT_NOT_AVAILABLE403La trascrizione è disabilitata per l’organizzazione o per il membro
SHARING_DISABLED403La condivisione è disabilitata per l’organizzazione o per il membro
RECORDING_NOT_FOUND404La registrazione non esiste o non puoi accedervi
INTERNAL_ERROR500Errore lato server