Introducción
Las claves de API permiten que herramientas externas y scripts se autentiquen con la API de Level. Puedes crear varias claves, configurar cada una con acceso de solo lectura o de lectura y escritura, y revocar cualquier clave de forma independiente sin afectar a las demás.
Usos típicos: conectar scripts personalizados, extraer datos de dispositivos hacia paneles externos o crear integraciones que no están cubiertas por los conectores integrados de Level.
Creación de una clave de API
Ve a Configuración → Claves de API, luego haz clic en + Crear clave de API en la parte superior derecha.
El modal Crear clave de API se abre.
Ingresa una Descripción — algo lo suficientemente específico como para que sepas para qué es esta clave meses después. «Sincronización de inventario» o «Integración personalizada con ConnectWise» es más útil que «Clave de API 1».
Selecciona un nivel de acceso:
Lectura y escritura — puede ver datos y crear, actualizar o eliminar registros
Solo lectura — puede ver datos pero no puede crear, actualizar ni eliminar
Haz clic en Crear clave.
💡 CONSEJO: Usa el acceso de solo lectura para integraciones que solo necesitan extraer datos (herramientas de informes, paneles externos). Reserva el acceso de lectura y escritura para integraciones que necesiten realizar cambios.
Gestión de claves existentes
La página Claves de API enumera todas las claves de tu organización. Cada fila muestra:
Clave de API — valor enmascarado con los últimos caracteres visibles para identificación
Descripción — la etiqueta que asignaste al crearla
Acceso — Lectura & escritura o Solo lectura
Último uso — marca de tiempo de la solicitud autenticada más reciente, o
--si nunca se ha usadoCreación — cuándo se generó la clave
Haz clic en el menú de tres puntos al final de cualquier fila para:
Copiar clave — copia el identificador de clave enmascarado en tu portapapeles (no el valor secreto completo)
Editar — actualizar la descripción o cambiar el nivel de acceso
Eliminar — revocar la clave de forma permanente
Edición de una clave
Haz clic en Editar del menú de tres puntos. El diálogo Actualizar clave de API se abre con la descripción actual y el nivel de acceso ya completados.
ℹ️ NOTA: Editar una clave no cambia el valor de la clave en sí. Cualquier integración que ya use esta clave seguirá funcionando — adoptará el nuevo nivel de acceso de inmediato.
Eliminación de una clave
Haz clic en Eliminar del menú de tres puntos. La clave se revoca de inmediato. Cualquier integración o script que use esa clave comenzará a recibir errores de autenticación en su próxima solicitud.
⚠️ ADVERTENCIA: La eliminación de claves es inmediata y permanente. Actualiza cualquier integración que use la clave antes de eliminarla, o espera que fallen.
Búsqueda de claves
Usa la barra de Búsqueda en la parte superior de la lista para filtrar claves por descripción. Útil si has acumulado muchas claves y necesitas encontrar una específica.
Preguntas frecuentes
¿Puedo ver el valor completo de la clave de API después de crearla? Sí. Haz clic en el menú de tres puntos de cualquier clave y selecciona Copiar clave para copiar el valor completo de la clave en tu portapapeles en cualquier momento.
¿Cuántas claves de API puedo crear? Crea tantas como necesites — una por integración es una práctica razonable, ya que permite revocar integraciones individuales sin afectar a las demás.
¿Cuál es la diferencia entre solo lectura y lectura y escritura? Las claves de solo lectura pueden recuperar datos de la API pero no pueden realizar cambios. Las claves de lectura y escritura pueden crear, actualizar y eliminar registros. Usa el nivel de acceso mínimo que tu integración realmente necesite.
¿Quién puede crear y gestionar claves de API? Técnicos con acceso a Configuración. Consulta Espacio de trabajo → Permisos para obtener más información sobre los controles de acceso basados en roles.
Una integración dejó de funcionar después de editar una clave. ¿Por qué? Cambiar el nivel de acceso de lectura y escritura a solo lectura tiene efecto de inmediato. Si la integración dependía del acceso de escritura, comenzará a fallar en cualquier solicitud que intente crear, actualizar o eliminar datos. Revisa los registros de errores de la integración en busca de respuestas 403.
¿Puedo saber qué integración está usando qué clave? El campo Descripción es el único identificador — Level no registra qué sistema realizó una solicitud de API determinada con una clave. Usa nombres descriptivos al momento de la creación para poder asociar claves con integraciones más adelante.