Introducción
La API pública de Level te permite interactuar de forma programática con tus dispositivos, grupos, automatizaciones y más. Es una API REST estándar: URLs orientadas a recursos, respuestas en JSON y códigos de estado HTTP.
Referencia completa de la API: developers.level.io
⚙️ REQUISITOS PREVIOS
Acceso de administrador en Level (para generar una clave de API)
Level API Pública
Generar una clave de API
Cada solicitud a la API requiere autenticación mediante una clave de API.
En Level, navega a Configuración → Claves de API.
Haz clic en Crear clave.
Dale a la clave un nombre descriptivo que identifique la integración o el script para el que se usará (por ejemplo, «Panel de monitoreo» o «Script de sincronización personalizado»).
Haz clic en Guardar y copia la clave generada.
💡 CONSEJO: Crea una clave de API por integración o script. Esto facilita la rotación o revocación del acceso para un caso de uso específico sin afectar a los demás.
Usar la API
Todas las solicitudes se autentican con tu clave de API. Consulta la referencia de la API en developers.level.io para la documentación de endpoints, formatos de solicitud y ejemplos de respuestas.
La API sigue las convenciones REST estándar:
URLs orientadas a recursos
Cuerpos de solicitud y respuesta en JSON
Verbos HTTP estándar:
GET,POST,PUT,DELETECódigos de estado HTTP estándar para estados de éxito y error
Administrar claves de API
Las claves de API se administran en Configuración → Claves de API. Desde allí puedes:
Ver todas las claves activas y sus nombres
Regenerar una clave (invalida la anterior de inmediato)
Eliminar una clave para revocar el acceso
⚠️ ADVERTENCIA: Regenerar o eliminar una clave interrumpe de inmediato cualquier integración o script que la utilice. Actualiza la clave en todos los sistemas dependientes antes de rotarla.
Preguntas frecuentes
¿Quién puede crear claves de API? Administradores de Level. La gestión de claves de API se encuentra en Configuración → Claves de API.
¿Hay un límite en la cantidad de claves de API que puedo crear? No, no hay ningún límite. Como práctica general, crea una clave por integración en lugar de compartir una sola clave entre varios sistemas.
¿Qué puedo hacer con la API? La lista completa de funcionalidades está en la documentación de referencia en developers.level.io. Los casos de uso más comunes incluyen consultar el estado de los dispositivos, activar automatizaciones, administrar grupos y etiquetas, y crear paneles personalizados o integraciones de informes.
¿Cómo autentico las solicitudes a la API? Incluye tu clave de API en el encabezado de la solicitud. El formato exacto del encabezado está documentado en developers.level.io.
¿Qué hago si una clave de API está comprometida? Elimínala de inmediato en Configuración → Claves de API. Genera una nueva clave y actualiza todas las integraciones que utilizaban la anterior.