Integraciones
Claves API y la API de Aprovisionamiento de Usuarios
La API de Aprovisionamiento de Usuarios te permite gestionar tu equipo de forma programática. Puedes invitar usuarios, eliminarlos, listar los miembros del equipo y su uso, listar las invitaciones pendientes, y crear reservas desde tus propios sistemas.
El acceso a la API se autentica con claves API, que el Propietario del espacio de trabajo gestiona en Configuración → Claves de API.
Es Bueno Saber
La API de Aprovisionamiento de Usuarios se habilita bajo petición. Si no ves la página de Claves API, contáctanos en contact@onecal.io para solicitar acceso.
Generar una clave API
- Ve a Configuración → Claves de API y haz clic en Generar Nueva Clave.
- Dale a la clave un nombre que describa para qué es.
- Elige el tipo de acceso: Acceso Completo o Solo Lectura. Las claves de solo lectura no pueden hacer cambios.
- Elige una expiración: 7 días, 30 días, 90 días, 1 año, o nunca.
El valor de la clave se muestra solo una vez, justo después de generarla. Asegúrate de copiarla inmediatamente, no podrás verla de nuevo.
Usar la API
Envía tu clave en el encabezado x-api-key. La URL base es:
https://app.onecal.io/api/v1
La referencia completa de la API, incluyendo autenticación, paginación, límites de tasa y cada endpoint, se encuentra en apidocs.onecal.io.
Monitorear y revocar claves
La lista de Claves API muestra cuándo se generó cada clave, cuándo expira, y cuándo se usó por última vez, para que puedas detectar claves sin usar o por expirar.
Haz clic en Revocar para deshabilitar una clave. Las aplicaciones que usan esa clave dejan de funcionar inmediatamente, y la revocación no se puede deshacer. Las claves que pertenecen a un usuario también se revocan automáticamente cuando ese usuario es eliminado del equipo.
