Las claves API le permiten interactuar con Middlewr de forma programática: crear enlaces, consultar analytics o gestionar su espacio de trabajo a través de la API. Cada clave tiene un nivel de permisos que controla a qué puede acceder. Esta guía cubre la creación, el uso y la eliminación de claves API.

Requisitos previos

Una cuenta Middlewr
El rol de Admin en el espacio de trabajo (la gestión de claves API está restringida a los administradores)

Paso 1: Acceder a las claves API

Vaya a Ajustes desde la barra lateral y haga clic en la pestaña Claves API. Esta página muestra todas las claves API existentes del espacio de trabajo, con su nombre, prefijo, nivel de permisos, fecha de último uso y fecha de creación.

Si aún no existe ninguna clave, verá un estado vacío invitándole a crear la primera.

Página de ajustes de Claves API

Paso 2: Crear una clave API

Haga clic en Crear clave API. Aparecerá un modal con dos campos:

Nombre — una etiqueta descriptiva para identificar esta clave (por ejemplo, "Pipeline CI/CD", "Automatización de marketing").
Permisos — seleccione el nivel de permisos para esta clave en el menú desplegable. Los niveles disponibles dependen de su propio rol: solo puede otorgar permisos iguales o inferiores a los suyos.

Haga clic en Crear para generar la clave.

Modal de creación de clave API

Paso 3: Copiar su clave

Después de la creación, un cuadro de diálogo muestra su clave API completa. Esta es la única vez que se muestra la clave — cópiela inmediatamente y guárdela en un lugar seguro (un gestor de secretos, una variable de entorno, etc.).

El prefijo de la clave (primeros caracteres seguidos de ...) seguirá visible en la tabla para su identificación, pero la clave completa no podrá recuperarse de nuevo.

Clave revelada después de la creación

Eliminar una clave API

Para eliminar una clave, haga clic en el botón de eliminar junto a ella en la tabla. Un cuadro de diálogo de confirmación le pedirá que confirme, advirtiendo que cualquier aplicación que use esta clave perderá el acceso de inmediato. Esta acción no se puede deshacer.

Buenas prácticas de seguridad

Una clave por integración — no comparta una misma clave entre varios servicios. Si una se ve comprometida, puede revocarla sin afectar a las demás.
Permisos mínimos — otorgue a cada clave solo el nivel de acceso que realmente necesita.
Supervise el uso — la columna "Último uso" le ayuda a identificar claves inactivas que deberían eliminarse.
Renueve periódicamente — cree una nueva clave, actualice su integración y después elimine la anterior.

Para ir más lejos

Ahora que sus claves API están configuradas, aquí tiene algunas opciones para explorar:

Importar y exportar enlaces en CSV — gestione sus enlaces en masa importando o exportando mediante archivos CSV, lo que se combina bien con flujos de trabajo basados en API.
Gestionar facturación y planes — actualice su espacio de trabajo para desbloquear límites de tasa API más altos y funcionalidades adicionales a medida que su uso aumenta.
A/B testing con split routing — combine la creación de enlaces por API con el split routing para automatizar sus flujos de trabajo de tests A/B.