Recursos
Todos los endpoints requieren Authorization: Bearer <access_token> y solo devuelven datos de tu organización.
Listar dispositivos
Sección titulada «Listar dispositivos»Scope: devices.read
GET /public/v1/devicesAuthorization: Bearer eyJ…Respuesta 200
Sección titulada «Respuesta 200»Array de dispositivos:
[ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "did": "11111111-2222-3333-4444-555555555555", "hardwareId": "AABBCCDDEEFF", "name": "Heladera San Martín #01", "status": "ONLINE", "lastSeenAt": "2026-09-22T15:40:12.000Z", "folderId": "7c9e6679-7425-40de-944b-e07fc1f90ae7" }, { "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "did": null, "hardwareId": null, "name": "Equipo sin asignar", "status": "OFFLINE", "lastSeenAt": null, "folderId": null }]| Campo | Tipo | Descripción |
|---|---|---|
id |
uuid | ID interno del dispositivo |
did |
string | null | Device ID lógico (si existe) |
hardwareId |
string | null | Identificador de hardware |
name |
string | null | Nombre visible |
status |
string | Estado calculado: ONLINE, OFFLINE, WARNING, DISABLED |
lastSeenAt |
string | null | Última actividad (ISO-8601) |
folderId |
uuid | null | Carpeta (grupo) a la que pertenece |
Árbol de carpetas
Sección titulada «Árbol de carpetas»Scope: folders.read
GET /public/v1/foldersAuthorization: Bearer eyJ…Respuesta 200
Sección titulada «Respuesta 200»Array de raíces; cada nodo puede tener children anidados:
[ { "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "name": "Sucursal San Martín", "parentId": null, "children": [ { "id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "name": "Cámara fría", "parentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "children": [] } ] }, { "id": "b2c3d4e5-f6a7-8901-2345-6789abcdef01", "name": "Depósito", "parentId": null, "children": [] }]| Campo | Tipo | Descripción |
|---|---|---|
id |
uuid | ID de la carpeta |
name |
string | Nombre |
parentId |
uuid | null | Padre; null en raíces |
children |
array | Subcarpetas (misma forma) |
Los dispositivos referencian carpetas con folderId en GET /devices.
Listar tableros NOC
Sección titulada «Listar tableros NOC»Scope: boards.read
GET /public/v1/boardsAuthorization: Bearer eyJ…Respuesta 200
Sección titulada «Respuesta 200»[ { "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890", "name": "NOC principal", "description": "Vista operativa de flota", "deviceIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" ], "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-09-20T18:22:11.000Z" }]| Campo | Tipo | Descripción |
|---|---|---|
id |
uuid | ID del tablero |
name |
string | Nombre |
description |
string | null | Descripción opcional |
deviceIds |
uuid[] | Dispositivos incluidos en el tablero |
createdAt / updatedAt |
string | ISO-8601 |
Detalle de un tablero
Sección titulada «Detalle de un tablero»Scope: boards.read
GET /public/v1/boards/{boardId}Authorization: Bearer eyJ…Respuesta 200
Sección titulada «Respuesta 200»Mismo objeto que un ítem de la lista (un solo tablero).
Errores
Sección titulada «Errores»| Código | Motivo |
|---|---|
404 |
boardId inexistente o de otra organización |
400 |
boardId no es un UUID válido |
Errores frecuentes (todos los recursos)
Sección titulada «Errores frecuentes (todos los recursos)»| Código | Motivo |
|---|---|
401 |
Token ausente, inválido, expirado o de otro tipo (JWT de usuario) |
403 |
Scope insuficiente |
429 |
Rate limit |