Las claves API permiten a herramientas externas y scripts autenticarse con la API de Level. Puede crear múltiples claves, limitar el alcance de cada una a acceso de solo lectura o lectura-escritura, y revocar cualquier clave independientemente sin afectar a las demás.
Usos típicos: conexión de scripts personalizados, extracción de datos de dispositivos en paneles de control externos, o creación de integraciones no cubiertas por los conectores integrados de Level.
Creación de una clave API
Navegue a Configuración → Claves API, luego haga clic en + Crear clave API en la esquina superior derecha.
Se abre el modal Crear clave API.
Ingrese una Descripción – algo lo suficientemente específico que sabrá para qué es esta clave meses a partir de ahora. "Sincronización de inventario" o "Integración personalizada de ConnectWise" es más útil que "Clave 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 o eliminar
Haga clic en Crear clave.
💡 CONSEJO: Use acceso de solo lectura para integraciones que solo necesitan extraer datos (herramientas de informes, paneles de control externos). Reserve lectura-escritura para integraciones que necesitan hacer cambios.
Gestión de claves existentes
La página Claves API lista todas las claves de su organización. Cada fila muestra:
Clave API – valor enmascarado con los últimos caracteres visibles para identificación
Descripción – la etiqueta que asignó en la creación
Acceso – Lectura y escritura o Solo lectura
Última vez utilizada – marca de tiempo de la solicitud autenticada más reciente, o
--si nunca se usóCreado – cuándo 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 a su portapapeles (no el valor secreto completo)
Editar – actualizar la descripción o cambiar el nivel de acceso
Eliminar – revocar la clave permanentemente
Edición de una clave
Haga clic en Editar en el menú de tres puntos. Se abre el diálogo Actualizar clave API con la descripción actual y el nivel de acceso precompletados.
ℹ️ NOTA: Editar una clave no cambia el valor de la clave en sí. Cualquier integración que ya use esta clave continúa funcionando – obtiene el nuevo nivel de acceso inmediatamente.
Eliminación de una clave
Haga clic en Eliminar en el menú de tres puntos. La clave se revoca inmediatamente. 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 clave es inmediata y permanente. Actualice cualquier integración que use la clave antes de eliminar, o espere que fallen.
Búsqueda de claves
Utilice 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 de clave API completo después de la creación? Sí. Haga clic en el menú de tres puntos en cualquier clave y seleccione Copiar clave para copiar el valor de clave completo a su portapapeles en cualquier momento.
¿Cuántas claves API puedo crear? Cree tantas como necesite – una por integración es una práctica razonable ya que le permite revocar integraciones individuales sin afectar a otras.
¿Cuál es la diferencia entre solo lectura y lectura-escritura? Las claves de solo lectura pueden recuperar datos de la API pero no pueden hacer cambios. Las claves de lectura-escritura pueden crear, actualizar y eliminar registros. Use el nivel de acceso mínimo que su integración realmente necesita.
¿Quién puede crear y administrar claves API? Técnicos con acceso a Configuración. Consulte Espacio de trabajo → Permisos para detalles sobre 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-escritura a solo lectura toma efecto inmediatamente. Si la integración dependía del acceso de escritura, comenzará a fallar en cualquier solicitud que intente crear, actualizar o eliminar datos. Compruebe los registros de errores de la integración para 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 API dada contra una clave. Use nombres descriptivos en el momento de la creación para poder asociar claves con integraciones más adelante.