Activos
Los Activos representan equipos, máquinas u objetos físicos monitoreados en Zeltask.
Rutas
| Operación | Método | Ruta |
|---|---|---|
| Listar | GET | /assets |
| Obtener por ID | GET | /assets/:id |
| Crear | POST | /assets |
| Editar | PATCH | /assets/:id |
| Eliminar | DELETE | /assets/:id |
Campos
| Campo | Tipo | Valores permitidos | Descripción |
|---|---|---|---|
name requerido | string | Cualquier valor que coincida con el tipo del campo. | Nombre del Activo. |
manufacturer requerido | string | Cualquier valor que coincida con el tipo del campo. | Fabricante del Activo. |
location requerido | number | object | Cualquier valor que coincida con el tipo del campo. | ID de Ubicación, u objeto expandido cuando se usa depth. |
refId | string | Cualquier valor que coincida con el tipo del campo. | Identificador de referencia externo o interno. |
model | string | Cualquier valor que coincida con el tipo del campo. | Modelo del Activo. |
serialNumber | string | Cualquier valor que coincida con el tipo del campo. | Número de serie del Activo. |
year | number | Cualquier valor que coincida con el tipo del campo. | Año de fabricación o instalación. |
status | string | online, offline, no-tracking | Estado a registrar en el historial del Activo al crear o editar. |
statusData.downtimeType | string | planned, unplanned | Tipo de detención. Es requerido cuando se edita un Activo con status offline. |
statusData.notes | string | Cualquier valor que coincida con el tipo del campo. | Notas opcionales para el registro de estado. |
statusData.dateFrom | string | Cualquier valor que coincida con el tipo del campo. | Fecha de inicio del estado en formato ISO 8601. |
statusData.dateTo | string | Cualquier valor que coincida con el tipo del campo. | Fecha de término del estado en formato ISO 8601. |
currentStatus | object | null | Cualquier valor que coincida con el tipo del campo. | Estado actual calculado del Activo. Es de solo lectura y contiene el documento relacionado de asset-statuses. |
Listar
Devuelve una respuesta paginada. El ejemplo usa limit=10, page=1, y depth=0.
URL de listado
Respuesta de listado
Obtener por ID
Respuesta del documento
Crear
Cuerpo de la solicitud
Editar
Cuerpo de la solicitud
Eliminar
Notas
- currentStatus no se envía directamente. La API lo calcula desde el historial de asset-statuses.
- Para cambiar el estado de un Activo, envía status y opcionalmente statusData en la solicitud de crear o editar.
- Eliminar registros puede estar restringido por permisos del usuario.