Aller au contenu

Authentification

Chaque requête à l’API Record Meeting nécessite une clé API. Vous créez les clés dans l’application sous Paramètres ➤ Clés API.

L'onglet Clés API des Paramètres avec le bouton Créer une clé

https://api.recordmeeting.com/v1

Les chemins des endpoints dans cette référence sont écrits avec le préfixe /v1, par exemple GET /v1/recordings. Ajoutez-les à https://api.recordmeeting.com.

Envoyez votre clé API dans l’en-tête Authorization. Les clés commencent par sk_rm_.

Authorization: Bearer sk_rm_your_key

Pour créer une clé, voir Guide utilisateur ➤ Clés API. Une clé a le même accès que votre compte : vos propres enregistrements et les enregistrements de l’organisation que vous êtes autorisé à voir.

Fenêtre de terminal
curl "https://api.recordmeeting.com/v1/recordings" \
-H "Authorization: Bearer sk_rm_your_key"

Les réponses réussies sont en JSON avec le résultat sous data. Les endpoints de liste qui paginent leurs résultats ajoutent un objet pagination. Certaines réponses contiennent aussi "success": true.

Les requêtes PATCH et DELETE répondent 204 No Content avec un corps vide lorsqu’elles réussissent.

Toutes les erreurs ont ce format :

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

Une requête sans en-tête Authorization valide reçoit 401.

CodeStatut HTTPSignification
INVALID_API_KEY401La clé n’existe pas ou a été révoquée
API_KEY_EXPIRED401La clé a expiré
USER_NOT_FOUND401Le compte auquel la clé appartient n’existe plus
AUTH_ERROR401L’authentification a échoué
CodeStatut HTTPSignification
VALIDATION_ERROR400Paramètres de requête invalides ou manquants
RECORDING_NOT_READY400L’enregistrement ne peut pas encore être partagé
ORGANIZATION_SUBSCRIPTION_EXPIRED402L’organisation propriétaire de l’enregistrement n’a plus d’abonnement Enterprise actif
FORBIDDEN403Vous n’êtes pas membre de l’organisation, ou vous n’êtes pas autorisé à voir ce que vous avez demandé
RECORDING_LOCKED403L’enregistrement est verrouillé. Passez à un plan supérieur pour l’ouvrir
SUBSCRIPTION_REQUIRED403L’action nécessite un plan payant
TRANSCRIPT_NOT_AVAILABLE403La transcription est désactivée pour l’organisation ou le membre
SHARING_DISABLED403Le partage est désactivé pour l’organisation ou le membre
RECORDING_NOT_FOUND404L’enregistrement n’existe pas ou vous ne pouvez pas y accéder
INTERNAL_ERROR500Erreur côté serveur