Claves API
Vídeo de la funcionalidad
¿A quién va dirigido?
- A los equipos técnicos que conectan Leexi con sus propias herramientas, scripts o productos internos.
- A los administradores que automatizan la recuperación de las llamadas, de las actas de la reunión y de los eventos de reunión.
Permisos y licencias
- La API pública está disponible a partir del plan AI Meeting.
- Consultar las claves requiere el permiso de lectura de las claves API; crearlas y modificarlas, el permiso de escritura.
Guía de uso
Abrir la página Claves API
Vaya a Ajustes > Configuración avanzada > Claves API. La lista muestra para cada clave su nombre, sus reglas de acceso, su descripción, sus permisos, su fecha de creación, su último uso y la persona que la creó.
Crear una clave
Haga clic en "Añadir". Leexi genera un ID de clave y un secreto. Cópielos de inmediato haciendo clic en cada campo: el secreto solo es visible en el momento de la creación.
Nombrar y describir la clave
Indique un nombre y una descripción que identifiquen la herramienta o el uso en cuestión. Es lo que le permitirá encontrar y revocar la clave correcta más adelante.
Elegir los permisos
Seleccione los permisos concedidos: lectura y escritura de las llamadas, lectura y escritura de los eventos de reunión, lectura de los usuarios, de los equipos y de la empresa. Active únicamente lo que la herramienta necesite realmente.
Definir las reglas de acceso
Hay tres modos disponibles:
- Vinculada a un usuario: la clave hereda los accesos del usuario elegido.
- Acceso a todo: la clave accede a todas las llamadas de la empresa.
- Acceso personalizado: después de guardar, se le redirige a la página Reglas de acceso para delimitar el alcance exacto.
Autenticar sus peticiones
Utilice el ID y el secreto como autenticación HTTP Basic en https://public-api.leexi.ai/v1/. Los endpoints, los parámetros y los formatos de respuesta se describen en la referencia de la API pública.
Para profundizar
- La columna "Último uso" permite detectar las claves inactivas, que conviene eliminar si la herramienta asociada ya no está en servicio.
- La API pública está limitada a 50 peticiones por minuto, y a 10 peticiones por minuto para la creación de llamadas.
- El nombre, la descripción, los permisos y las reglas de acceso de una clave se modifican en cualquier momento haciendo clic en la línea correspondiente: el ID y el secreto, en cambio, no cambian.
- Los webhooks cubren la necesidad inversa: en lugar de consultar la API, recibe un evento en cuanto una llamada ha sido procesada.
Preguntas frecuentes
Puntos de atención
- Una clave da acceso a los datos sin autenticación de usuario: conserve el secreto en un gestor de secretos, nunca en un repositorio de código ni en un mensaje.
- El modo "Acceso a todo" ignora la separación por equipos: resérvelo para las integraciones que realmente lo necesiten.
- Una clave sigue siendo válida aunque la persona que la creó deje la empresa: revise las claves cuando se produzcan salidas.
- Los permisos de escritura permiten crear y modificar datos en Leexi: concédalos con moderación.