Asignar operador a turno

Asigna un operador a un turno por su ID (el que devuelve PUT /v1/shifts/targets), incluso en turnos que ya terminaron. Sin start, el operador cubre el turno desde su inicio.

El operador toma la máquina en start y la conserva hasta el final del turno, o hasta una asignación posterior. Si el turno todavía no tiene a nadie asignado, el operador cubre el turno completo. Para registrar varios operadores en un turno, envíalos en orden cronológico: se rechaza un start anterior al último cambio de operador del turno. Enviar la misma asignación otra vez no causa problemas.

Las métricas de operador del turno se recalculan en segundo plano.

Errores:

  • 400: ningún turno coincide, o start está fuera del turno, en el futuro, o antes del último cambio de operador del turno.
  • 403: el turno tiene producción marcada como revisada, lo que lo bloquea.
  • 404: el operador no existe en tu empresa.

Parámetros de ruta

shift_id*Shift Id

El ID del turno.

Cuerpo de la solicitud

application/json

Definiciones de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

Pruébalo en vivo
POST
/v1/shifts/{shift_id}/operator

Este endpoint requiere autenticación. Pega un token en la sección Autorización, más abajo.

curl -X POST "https://example.com/v1/shifts/0/operator" \  -H "Content-Type: application/json" \  -d '{    "operatorId": 1063  }'
{  "shiftId": 48213,  "machineId": 12,  "operatorId": 1063,  "start": "2026-10-12T10:00:00Z"}

Asignar por hora POST

Asigna un operador al turno que la máquina `machineId` estaba corriendo en `start`. Úsalo para registrar quién operó una máquina después de que terminó el turno, por ejemplo un día después desde un sistema de planeación. Para un turno en curso en una terminal de planta, `POST /v1/realtime/{machine_id}/operator` es la llamada más corta. El operador toma la máquina en `start` y la conserva hasta el final del turno, o hasta una asignación posterior. Si el turno todavía no tiene a nadie asignado, el operador cubre el turno completo. Para registrar varios operadores en un turno, envíalos en orden cronológico: se rechaza un `start` anterior al último cambio de operador del turno. Enviar la misma asignación otra vez no causa problemas. Las métricas de operador del turno se recalculan en segundo plano. Errores: * `400`: ningún turno coincide, o `start` está fuera del turno, en el futuro, o antes del último cambio de operador del turno. * `403`: el turno tiene producción marcada como revisada, lo que lo bloquea. * `404`: el operador no existe en tu empresa.

Listar las señales de una máquina GET

Devuelve las señales de sensor en crudo que expone una máquina, con el `public_id` necesario para leer sus muestras. Una señal es un canal de sensor que lee la máquina, nombrado según la magnitud física que transporta (`current`, `count`, `product_count`, `cycle`, `energy`, `temperature`, `pressure`, ...). Una máquina puede exponer varias señales con el mismo `name`; su `display_name` las distingue. No se listan las señales eliminadas ni las que no tienen un tipo. `description` viene en inglés por defecto; pasa `language=es` para obtenerla en español. Una descripción sin traducción al idioma pedido se devuelve en inglés.