Cadastrar grupo de máquinas

Autenticação: Authorization: Bearer <chave da API pública Sensio>. O servidor determina a empresa pela chave; não envie company/user no corpo. Não confundir esta chave com o token da API do Apidog. Limite compartilhado de 25 requisições a cada 60 segundos por empresa; ao exceder, HTTP 429 e bloqueio temporário de 150 segundos.

Cria grupo de máquinas e retorna HTTP 201. Exige options.pcp=true. name e code são obrigatórios e não vazios; código único na empresa, comparado literalmente.

Com engineeringModule=true também exige nickname não vazio, informsPosition booleano (false é válido) e directLabor como ID de mão de obra direta da empresa. Fora desse módulo, esses campos são opcionais; directLabor, se informado, também é validado na empresa. Arrays machinesEquivalent/towers/positions/correctors devem conter textos.

Corpo direto, sem wrapper. company, user, dateCreated, _id, status, maskCodification e quaisquer outras propriedades fora do schema são rejeitados. Repetir o código não atualiza o grupo: retorna 409. Preservar o código do grupo separado do sufixo Resource.code para integração MES.

Limitação do contexto de usuário: a chave gerada atualmente contém company/method: API, mas não _id. A resolução do usuário no validador só atende productionRoutes, que não inclui esta rota. Se o controller precisar de usuário e ele estiver ausente, pode ocorrer HTTP 500 ou ausência de autoria. Não envie user no corpo como contorno; a correção desse contexto depende do backend.

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢201Criado

application/json

Cadastrar grupo de máquinas

Bodyapplication/json

Exemplo

{
    "success": true,
    "message": "Grupo de máquinas criado com sucesso.",
    "response": {
        "_id": "64f1c0c2a1b2c3d4e5f60711",
        "name": "CNC",
        "code": "9TOAC042",
        "company": "64f1c0c2a1b2c3d4e5f60717",
        "user": "64f1c0c2a1b2c3d4e5f60716",
        "informsPosition": false,
        "dateCreated": "2026-11-11T13:00:00.000Z",
        "machinesEquivalent": [],
        "towers": [],
        "positions": [],
        "correctors": []
    }
}

🟠400Pedido Inválido

🟠402

🟠403Proibido

🟠404Registo Não Encontrado

🟠409

🟠429

🔴500Erro do Servidor

Cadastrar grupo de máquinas

Requisição

Códigos de solicitação

Respostas