Ir al contenido

Recursos

Todos los endpoints requieren Authorization: Bearer <access_token> y solo devuelven datos de tu organización.


Scope: devices.read

GET /public/v1/devices
Authorization: Bearer eyJ…

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

Scope: folders.read

GET /public/v1/folders
Authorization: Bearer eyJ…

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.


Scope: boards.read

GET /public/v1/boards
Authorization: Bearer eyJ…
[
{
"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

Scope: boards.read

GET /public/v1/boards/{boardId}
Authorization: Bearer eyJ…

Mismo objeto que un ítem de la lista (un solo tablero).

Código Motivo
404 boardId inexistente o de otra organización
400 boardId no es un UUID válido

Código Motivo
401 Token ausente, inválido, expirado o de otro tipo (JWT de usuario)
403 Scope insuficiente
429 Rate limit