Ir al contenido

Autenticación

Cada solicitud a la API de Record Meeting necesita una clave de API. Las claves se crean en la aplicación, en Ajustes ➤ Claves de API.

La pestaña Claves de API de Ajustes con el botón Crear clave

https://api.recordmeeting.com/v1

Las rutas de los endpoints de esta referencia se escriben con el prefijo /v1, por ejemplo GET /v1/recordings. Añádelas a https://api.recordmeeting.com.

Envía tu clave de API en el encabezado Authorization. Las claves empiezan por sk_rm_.

Authorization: Bearer sk_rm_your_key

Para crear una clave, consulta Guía de usuario ➤ Claves de API. Una clave tiene el mismo acceso que tu cuenta: tus propias grabaciones y las grabaciones de la organización que tienes permitido ver.

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

Las respuestas correctas son JSON con el resultado en data. Los endpoints de lista que paginan sus resultados añaden un objeto pagination. Algunas respuestas también incluyen "success": true.

Las solicitudes PATCH y DELETE responden 204 No Content con un cuerpo vacío cuando tienen éxito.

Todos los errores tienen este formato:

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

Una solicitud sin un encabezado Authorization válido recibe 401.

CódigoEstado HTTPSignificado
INVALID_API_KEY401La clave no existe o ha sido revocada
API_KEY_EXPIRED401La clave ha caducado
USER_NOT_FOUND401La cuenta a la que pertenece la clave ya no existe
AUTH_ERROR401La autenticación ha fallado
CódigoEstado HTTPSignificado
VALIDATION_ERROR400Parámetros de la solicitud no válidos o ausentes
RECORDING_NOT_READY400La grabación todavía no se puede compartir
ORGANIZATION_SUBSCRIPTION_EXPIRED402La organización propietaria de la grabación ya no tiene una suscripción Enterprise activa
FORBIDDEN403No eres miembro de la organización, o no puedes ver lo que has solicitado
RECORDING_LOCKED403La grabación está bloqueada. Mejora tu plan para abrirla
SUBSCRIPTION_REQUIRED403La acción requiere un plan de pago
TRANSCRIPT_NOT_AVAILABLE403La transcripción está desactivada para la organización o el miembro
SHARING_DISABLED403El uso compartido está desactivado para la organización o el miembro
RECORDING_NOT_FOUND404La grabación no existe o no puedes acceder a ella
INTERNAL_ERROR500Error en el servidor