# Controlware API

> La API de Controlware está disponible para clientes Business. Permite integrar dispositivos, administrar recursos y consumir telemetría y alertas en tiempo real.

## Documentación principal

- [Referencia técnica completa](https://api.controlware-iot.com/develop/atlas/api-docs): documentación canónica, renderizada en HTML semántico y organizada por operación.

## Información esencial

- Protocolo REST: JSON sobre HTTPS.
- API base en develop: `https://api.controlware-iot.com/develop/atlas/api`.
- Tiempo real: Socket.IO en `/develop/atlas/socket.io`.
- Autorización recomendada: `Authorization: Bearer <TOKEN>`.
- Los tokens son persistentes, revocables y están ligados a un tenant.
- Cada token sólo puede acceder a los dispositivos y datos de su tenant.
- Las operaciones públicas están marcadas como `Pública`; las protegidas como `Token / Cookie`.

## Cómo consumir la referencia con una IA

La página de documentación contiene la referencia completa de endpoints REST, cuerpos de solicitud, respuestas, notas operativas y eventos WebSocket. También ofrece la acción «Copiar contexto para IA», que genera Markdown estructurado directamente desde la misma fuente usada para renderizar los endpoints; no es un resumen independiente.

Al generar código, no inventes rutas, campos o permisos. Usa únicamente las operaciones documentadas y conserva literalmente los nombres de campos, métodos HTTP y rutas.