Introducción
Las claves de API permiten que herramientas y scripts externos se autentiquen con la API de Level. Puede 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 de control externos o crear integraciones que no están cubiertas por los conectores integrados de Level.
ℹ️ NOTA: Las claves de API no se utilizan para instalar el agente de Level. Para inscribir un dispositivo, use la clave de instalación desde Agregar nuevo dispositivo en la página de listado de dispositivos — consulte Instalación en Windows, Instalación en Linux, o Instalación en macOS.
Crear una clave de API
Vaya a Configuración → Claves de API, luego haga clic en + Crear clave de API en la parte superior derecha.
El Crear clave de API se abre.
Ingrese una Descripción — algo lo suficientemente específico como para saber para qué es esta clave meses después. «Sincronización de inventario» o «Integración personalizada de ConnectWise» es más útil que «Clave de API 1».
Seleccione 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
Haga clic en Crear clave.
💡 CONSEJO: Use el acceso de solo lectura para las integraciones que únicamente necesiten extraer datos (herramientas de informes, paneles externos). Reserve el acceso de lectura y escritura para las integraciones que necesiten realizar cambios.
Administrar las claves existentes
La página Claves de API muestra todas las claves de su organización. Cada fila muestra:
Clave de API — valor enmascarado con los últimos caracteres visibles para su identificación
Descripción — la etiqueta que asignó 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 utilizadoCreada — fecha en que se generó la clave
Haga clic en el menú de tres puntos al final de cualquier fila para:
Copiar clave — copia el identificador de clave enmascarado al portapapeles (no el valor secreto completo)
Editar — actualizar la descripción o cambiar el nivel de acceso
Eliminar — revocar la clave de forma permanente
Editar una clave
Haga clic en Editar desde el 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 — el nuevo nivel de acceso se aplica de inmediato.
Eliminar una clave
Haga clic en Eliminar desde el 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 la clave es inmediata y permanente. Actualice cualquier integración que use la clave antes de eliminarla, o espere que fallen.
Buscar claves
Use la barra de Búsqueda en la parte superior de la lista para filtrar claves por descripción. Útil si ha acumulado muchas claves y necesita encontrar una específica.
Preguntas frecuentes
¿Puedo ver el valor completo de la clave de API después de crearla? Sí. Haga clic en el menú de tres puntos de cualquier clave y seleccione Copiar clave para copiar el valor completo de la clave al portapapeles en cualquier momento.
¿Cuántas claves de API puedo crear? Cree tantas como necesite — 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 ningún cambio. Las claves de lectura y escritura pueden crear, actualizar y eliminar registros. Use el nivel de acceso mínimo que su integración realmente necesite.
¿Quién puede crear y administrar claves de API? Los técnicos con acceso a Configuración. Consulte Área de trabajo → Permisos para más detalles 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 surte 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. Revise los registros de errores de la integración en busca de respuestas 403.
¿Puedo saber qué integración usa qué clave? El campo Descripción es el único identificador — Level no registra qué sistema realizó una solicitud de API determinada con una clave. Use nombres descriptivos al momento de crearlas para poder relacionar las claves con las integraciones más adelante.