La API pública de Level te permite construir integraciones personalizadas, extraer datos de dispositivos y alertas en tus propias herramientas, y automatizar flujos de trabajo fuera del conjunto de integraciones nativas de Level.

La API utiliza REST y devuelve JSON. Todas las solicitudes deben autenticarse con una clave API. No hay límite de velocidad estricto, pero las llamadas excesivas serán limitadas.

⚙️ REQUISITOS PREVIOS

Acceso de administrador de Level (para generar claves API)
Conocimientos básicos de API REST y JSON
Un cliente HTTP o biblioteca para realizar solicitudes (curl, Postman, Python requests, etc.)

API Pública de Level

Genera una clave API

1. Inicia sesión en Level como administrador.

2. Ve a Configuración → Claves API.

3. Haz clic en Generar nueva clave.

4. Dale un nombre a la clave (por ejemplo, "Integración personalizada" o "Sincronización de datos").

5. Haz clic en Crear clave. Level genera una clave secreta. Cópiala y guárdala de forma segura — no podrás verla de nuevo.

⚠️ ADVERTENCIA : Las claves API otorgan acceso programático a tu organización Level. Trátalas como contraseñas. Si una clave se ve comprometida, elimínala inmediatamente y genera una nueva.

Autenticación

Incluye tu clave API en el encabezado Authorization de cada solicitud:

Authorization: Bearer YOUR_API_KEY

Ejemplo con curl:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.level.io/v1/devices

Puntos finales de API

La API se aloja en https://api.level.io/v1.

Dispositivos

GET /devices — Enumera todos los dispositivos
GET /devices/{id} — Obtén un dispositivo específico
GET /devices/{id}/alerts — Enumera las alertas de un dispositivo

Alertas

GET /alerts — Enumera todas las alertas
GET /alerts/{id} — Obtén una alerta específica

Organizaciones

GET /organizations — Enumera todas las organizaciones
GET /organizations/{id} — Obtén una organización específica

Solicitudes y respuestas

Las respuestas se devuelven en formato JSON con un código de estado HTTP apropiado.

Solicitud de ejemplo:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.level.io/v1/devices?limit=10

Respuesta de ejemplo:

{\n  "data": [\n    {\n      "id": "device-123",\n      "name": "ACME-PC-001",\n      "organization_id": "org-456",\n      "status": "online"\n    }\n  ],\n  "pagination": {\n    "total": 42,\n    "limit": 10,\n    "offset": 0\n  }\n}

Paginación

Las respuestas de lista admiten paginación a través de los parámetros limit y offset.

GET /devices?limit=20&offset=40

Gestiona claves API

Puedes revocar una clave API en cualquier momento:

Ve a Configuración → Claves API.
Encuentra la clave en la lista y haz clic en Revocar.

Una vez revocada, la clave ya no funcionará para nuevas solicitudes.

💡 CONSEJO : Si sospechas que una clave se ha visto comprometida, revócala inmediatamente y crea una nueva. Las solicitudes en curso que utilicen la clave comprometida fallarán, pero esto evitará el acceso no autorizado.

Preguntas frecuentes

¿Quién puede generar una clave API? Solo los administradores de Level pueden generar y revocar claves API.
¿Hay un límite en la cantidad de claves API que puedo crear? No. Puedes crear tantas claves como necesites.
¿Puedo restringir los permisos de una clave API a dominios u organizaciones específicas? Actualmente, las claves API tienen acceso a toda la organización. Los permisos granulares están en la hoja de ruta.
¿Qué pasa si mi clave API se ve comprometida? Revócala inmediatamente. Ve a Configuración → Claves API, encuentra la clave y haz clic en Revocar. Crea una nueva.
¿La API admite solicitudes POST o PUT para modificar datos? Actualmente, la API es de solo lectura. Las capacidades de escritura (POST, PUT, DELETE) están en desarrollo.