Introducción
Las claves API permiten que herramientas externas y scripts se autentiquen con la API de Level. Puede crear múltiples claves, asignar a cada una acceso de solo lectura o lectura y escritura, y revocar cualquier clave independientemente sin afectar a las demás.
Usos típicos: conectar scripts personalizados, extraer datos de dispositivos en paneles externos o crear integraciones que no estén cubiertas por los conectores integrados de Level.
Creating an API Key
Navigate to Settings → API keys , then click + Create API key in the top right.
The Create API key modal opens.
Enter a Description — 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 API 1."
Select an access level:
Read and write — puede ver datos y crear, actualizar o eliminar registros
Read-only — puede ver datos pero no puede crear, actualizar o eliminar
Click Create key .
💡 TIP: Utilice acceso de solo lectura para integraciones que solo necesitan extraer datos (herramientas de informes, paneles externos). Reserve lectura y escritura para integraciones que necesiten realizar cambios.
Managing Existing Keys
The API keys página lista todas las claves de su organización. Cada fila muestra:
API key — valor enmascarado con los últimos caracteres visibles para identificación
Description — the label you assigned at creation
Access — Read & write or Read-only
Last usedmarca de tiempo de la solicitud autenticada más reciente, o
--if never usedCreated — when the key was generated
Haga clic en el menú de tres puntos al final de cualquier fila para:
Copy key — copia el identificador de clave enmascarado en su portapapeles (no el valor secreto completo)
Edit — actualizar la descripción o cambiar el nivel de acceso
Delete — permanently revoke the key
Editing a Key
Click Edit del menú de tres puntos. ElUpdate API key el diálogo se abre con la descripción actual y el nivel de acceso rellenados previamente.
ℹ️ NOTA: Editar una clave no cambia el valor de la clave en sí. Cualquier integración que ya use esta clave continúa funcionando — recoge el nuevo nivel de acceso inmediatamente.
Deleting a Key
Click Delete del 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 claves es inmediata y permanente. Actualice todas las integraciones que usan la clave antes de eliminarla, o espere que fallen.
Searching Keys
Use the Search barra 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 API después de la creación? Sí. Haga clic en el menú de tres puntos en cualquier clave y seleccioneCopy key para copiar el valor de la clave completa en su portapapeles en cualquier momento.
How many API keys can I create? Cree las que 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 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. Utilice el nivel de acceso mínimo que su integración realmente necesita.
Who can create and manage API keys? Técnicos con acceso a Configuración. VerEspacio de trabajo → Permisos para obtener detalles sobre controles de acceso basados en roles.
Una integración dejó de funcionar después de que edité una clave. ¿Por qué? Cambiar el nivel de acceso de lectura y 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. Verifique los registros de errores de la integración para ver 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 dada contra una clave. Utilice nombres descriptivos en el momento de la creación para que pueda hacer coincidir claves con integraciones más tarde.