Referência OpenAPI (Swagger)

Especificação OpenAPI 3.0.3 de todas as rotas documentadas (211 combinações método + rota, 145 operações), com esquemas de dados, autenticação (bearerAuth para usuários e edgeKey para o coletor industrial) e exemplos.

🔎 Abrir a referência interativa (somente leitura)⬇ Baixar openapi.yaml

Como usar

• Referência interativa: lista as rotas por módulo, com parâmetros, corpos e respostas. O botão "Try it out" fica desativado: esta página não envia chamadas a nenhum servidor.
• Importar em ferramentas: baixe o openapi.yaml e importe no Postman (Import → arquivo), no Insomnia ou no Swagger Editor. Defina o servidor (BASE_URL) do seu ambiente e o token de login (Authorization: Bearer ...).
• Exemplos são sintéticos: valores como "Exemplo", 1 ou false apenas ilustram o formato; troque por dados reais do seu ambiente.

Para entender autenticação, permissões e erros antes de testar, leia Autenticação e autorização e Tratamento de erros.