APIs
Visão Geral das APIs
A SEW fornece uma camada de API moderna e totalmente acessível que permite integrar, automatizar e estender todas as partes da plataforma. Praticamente todos os recursos da plataforma SEW — incluindo gerenciamento de dispositivos, operações de projeto, execução de pipelines, gerenciamento de identidades e engenharia remota — são expostos por meio de APIs seguras e versionadas. Isso permite que os clientes criem fluxos de trabalho personalizados, automatizem processos de engenharia e integrem a SEW aos sistemas corporativos e cadeias de ferramentas existentes.
Esta seção documenta as principais APIs disponíveis na SEW e fornece exemplos práticos para ajudá-lo a começar rapidamente. Os exemplos de código são apresentados em linguagens comuns, como Python, com padrões que podem ser adaptados para JavaScript, C# e outros ambientes, conforme necessário.
Principais Categorias de API
Asset API
A Asset API fornece acesso programático a dispositivos, projetos, grupos de recursos e metadados relacionados. Ela permite que sistemas externos listem, consultem, atualizem e orquestrem ativos dentro da SEW, sendo ideal para sincronização com CMDB, integração automatizada de ativos e gerenciamento do ciclo de vida de ativos orientado por dados.
Job API
A Job API permite acionar, monitorar e gerenciar tarefas operacionais, como backups, implantações, snapshots, rotações de senha e outras ações de pipeline. Ela é comumente utilizada para automação no estilo CI/CD, backups noturnos e integração com sistemas de tickets ou de fluxo de trabalho.
Identity API
A Identity API fornece acesso a informações de usuários, funções e permissões. Ela oferece suporte à integração com sistemas de identidade externos, fluxos de provisionamento personalizados e automação avançada em torno de direitos de acesso e operações baseadas em RBAC.
IDEaaS API
A IDEaaS API expõe recursos de engenharia baseados em navegador, permitindo que ferramentas externas ou orquestradores criem sessões de engenharia, abram projetos de PLC e interajam remotamente com IDEs específicas de fabricantes. Isso viabiliza pipelines de engenharia automatizados, workspaces remotos e integração profunda com plataformas DevOps ou de TI/TO existentes.
Exemplos de Código
Para ajudá-lo a integrar rapidamente as APIs da SEW ao seu ambiente, esta seção inclui exemplos práticos e de ponta a ponta. Esses exemplos demonstram como autenticar, recuperar dados, acionar ações de pipeline e integrar com aplicações externas.
Cada exemplo destaca as melhores práticas, como gerenciamento de tokens, tratamento de erros, paginação e configurações de segurança recomendadas.