v1Referência da APIOperadores

Eliminar um operador

Elimina um operador da lista.

Os registos de produção e os turnos que o referenciam ficam a apontar para um registo que já não existe, por isso, para alguém que simplesmente saiu, manter o registo preserva o histórico dos seus turnos.

Parâmetros de caminho

operator_id*Operator Id

O ID do operador.

Corpo da resposta

application/json

Experimente em direto
DELETE
/v1/operators/{operator_id}

Este endpoint requer autenticação. Cole um token na secção Autorização, mais abaixo.

curl -X DELETE "https://example.com/v1/operators/0"
Vazio

Atualizar um operador PATCH

Atualiza parcialmente um operador: envie apenas os campos que mudam.

Criar registos de produção POST

Cria um ou vários registos de produção. O corpo é um **array** JSON, mesmo para um único registo. Este é o endpoint que um MES, ERP ou terminal de fábrica usa para enviar produção para o Pulsar. `machine` e `sku` são referências que aceitam um `id` ou um `name`, por isso um sistema que só conhece nomes de linhas e códigos de produto não tem de resolver primeiro os IDs do Pulsar. Um registo de produção descreve um intervalo fechado: `start` e `end` são obrigatórios, `end` é igual ou posterior a `start`, e ambos se situam dentro de um único turno da máquina. São aceites turnos passados, por isso os registos podem ser enviados dias depois da produção. Para registar o que está a acontecer no turno em curso de uma máquina, use os endpoints de tempo real. Os **defeitos** (`type: "defects"`) somam-se. Vários registos de defeitos podem cobrir o mesmo intervalo, num pedido ou em vários, e cada um é registado, por isso envie cada lote uma única vez e repita apenas um pedido que falhou (um pedido falhado não regista nada). `start` e `end` podem ser o mesmo instante para defeitos encontrados num momento pontual: ```json [ {"type": "defects", "count": 3, "nominalSpeed": 60, "machine": {"name": "Press 4"}, "sku": {"name": "GAL-1042"}, "start": "2026-10-12T14:00:00Z", "end": "2026-10-12T22:00:00Z"}, {"type": "defects", "count": 1, "nominalSpeed": 60, "machine": {"name": "Press 4"}, "sku": {"name": "GAL-1042"}, "start": "2026-10-12T17:42:10Z", "end": "2026-10-12T17:42:10Z"} ] ``` Os registos `total` e `correct` não se podem sobrepor a outro registo do mesmo tipo, máquina e SKU. A resposta lista os registos deste pedido. A qualidade e o OEE dos turnos afetados são recalculados em segundo plano, normalmente em poucos minutos.