API claves

¿Quién puede crear claves?

Las claves API las crean los administradores del equipo. Debes estar autenticado y tener acceso de administrador a tu equipo. Cada clave tiene como ámbito su equipo y hereda los permisos de su equipo.

Creando una clave API

Navegue hasta Administrador, luego Equipo, luego API Claves. Haga clic en Crear clave API y asígnele un nombre descriptivo (por ejemplo, "sincronización de CRM" o "exportación de análisis"). La clave se muestra una vez al crearla; cópiela inmediatamente.

Usando claves API

Incluya su clave API como token de portador en el encabezado de Autorización de sus solicitudes HTTP.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept: application/json" \
     https://your-domain.test/api/v1/organizer/events

Gestión de claves

Vea todas sus claves API en la sección Claves API. Cada clave muestra su nombre, una vista previa de los últimos cuatro caracteres (para identificación), cuándo se creó y cuándo se usó por última vez. La marca de tiempo utilizada por última vez le ayuda a identificar claves inactivas que pueden revocarse con seguridad.

Revocar claves

Elimine una clave cuando ya no sea necesaria o si puede haber sido comprometida. La revocación entra en vigor de inmediato: todas las solicitudes que utilicen esa clave fallarán con una respuesta 401 no autorizada. Las integraciones conectadas dejarán de funcionar hasta que se actualicen con una nueva clave.

Mejores prácticas de seguridad

Mantenga sus claves API seguras con estas pautas:

• Almacene claves en variables de entorno o en un administrador de secretos, nunca en el código fuente
• Rote las claves periódicamente: cree una nueva clave, actualice su integración y luego revoque la anterior
• Utilice claves independientes para diferentes integraciones para que pueda revocar una sin afectar a las demás
• Supervise la marca de tiempo utilizada por última vez para detectar un uso inesperado
• Nunca compartas claves en chat, correo electrónico o canales públicos.