Classificar paragens

Scope necessário: stop_classifications.update. Relacionados: reports.read para encontrar as paragens a classificar com POST /v1/reports/stops; stop_catalogs.read para listar as causas e os componentes que cada máquina aceita com GET /v1/stops/classification-options.

Classifica paragens: define a sua causa geral, causa específica, componente e descrição. O corpo é um array JSON de até 1000 linhas, cada uma com a sua própria classificação.

Como identificar uma paragem. Uma paragem é identificada pela sua máquina e pela hora em que começou, não por um id: os ids de paragem podem mudar quando um turno é recalculado. Obtenha machine.id e stop.startTime de POST /v1/reports/stops. As paragens abertas, ainda em curso, também podem ser classificadas.

Como escolher uma classificação. Cada máquina aceita apenas as causas da sua árvore de perdas e os seus próprios componentes, listados por GET /v1/stops/classification-options. Uma linha define pelo menos um generalCauseId ou uma description; specificCauseId requer um generalCauseId.

Uma linha substitui a classificação da paragem. O que uma linha omite é apagado: enviar apenas generalCauseId remove a causa específica, o componente e a descrição da paragem. Enviar as mesmas linhas novamente não tem efeitos, por isso um pedido cujo tempo limite se esgotou pode ser repetido tal como está. Uma causa definida por um operador no Pulsar também é substituída.

Cada linha é devolvida com um status, e só as linhas classified alteraram alguma coisa:

  • classified: a paragem tem agora esta classificação.
  • stopNotFound: a máquina machineId não tem nenhuma paragem que tenha começado em startTime, ou não é uma das suas máquinas.
  • duplicateStop: outra linha do mesmo pedido indica a mesma paragem, por isso nenhuma das duas foi aplicada.
  • generalCauseNotAvailable: a causa geral não está na árvore de perdas da máquina.
  • specificCauseNotAvailable: a causa específica não fica abaixo da causa geral nesta máquina.
  • componentNotAvailable: o componente não está atribuído à máquina.

O esquema também lista missingClassification e missingGeneralCause. Este endpoint rejeita essas linhas com 422 antes de chegarem ao Pulsar, por isso não as irá receber.

As linhas do resultado repetem as suas linhas pela ordem do pedido, com startTime normalizado para UTC; faça-as corresponder pela posição em vez de comparar os textos de startTime.

As linhas classified de um pedido são guardadas em conjunto. As métricas que dependem das causas das paragens são recalculadas em segundo plano, por isso os relatórios podem demorar um momento a mostrar a alteração.

Corpo do pedido

application/json

Definições de TypeScript

Utilize o tipo request body em TypeScript.

Um array JSON. Cada elemento tem estes campos:

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

Experimente em direto
PUT
/v1/stops/classifications

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

curl -X PUT "https://example.com/v1/stops/classifications" \  -H "Content-Type: application/json" \  -d '[    {      "machineId": 12,      "startTime": "2026-10-12T10:00:00Z"    }  ]'
[  {    "machineId": 12,    "startTime": "2026-10-12T10:00:00Z",    "generalCauseId": "d56aece5-a92a-462e-b275-919e15446bba",    "specificCauseId": "f89b5866-2d26-45a1-8cfc-8295557594d8",    "componentId": "3e8e81cf-7521-4ef9-b6c9-40074aa764c5",    "description": "Bearing seized on the main motor",    "status": "classified"  }]