NEO Middleware: um API gateway configurável para suas integrações
O NEO Middleware é a camada de integração da plataforma NEO: um API gateway configurável em que cada integração é cadastrada em um painel administrativo, no lugar de código sob medida. Ele conecta módulos NEO e sistemas externos — ERP, SAP, LIMS — validando, transformando e roteando cada requisição, com API keys, agendamento e trilha de auditoria completa.
O NEO Middleware fica entre os sistemas que chamam você e os backends privados que respondem. Em vez de escrever e implantar um novo serviço para cada integração, você cadastra um endpoint: um caminho e um método públicos mapeados para uma URL de destino no backend. Adicionar ou mudar uma integração é uma mudança de configuração, não de código.
Cada chamada percorre o mesmo pipeline: autenticar → validar → transformar → rotear para o backend → registrar. No caminho, ela pode validar requisição e resposta contra um JSON Schema, remodelar payloads entre formatos, ingerir um arquivo, distribuir uma requisição para vários backends e registrar o resultado — de modo que a integração é observável e governada desde a primeira requisição.
O que o NEO Middleware dá às suas integrações
Um pipeline para cada requisição
Chamadas diretas, reexecuções agendadas e falhas reprocessadas percorrem as mesmas etapas, então o comportamento é consistente independentemente de como a requisição chega.
- API key + scopesVerificada contra os scopes e a lista permitida do endpoint
- JSON SchemaRequisição e resposta verificadas antes de encaminhar
- JSONata / HandlebarsRemodela o payload entre formatos
- Encaminhar (proxy)Para o backend, protegido por circuit breaker
- Log da requisiçãoStatus, latência e resultado registrados
Cadastre e gerencie endpoints
Cada endpoint mapeia um caminho e método públicos para uma URL de destino no backend. Aponte para uma URL completa ou para um base path compartilhado e roteie dinamicamente para backends diferentes por regra de negócio quando precisar — tudo em um único catálogo.
Valide requisições e respostas
Vincule um JSON Schema a um endpoint e o gateway verifica o payload antes de chegar ao backend, devolvendo um erro preciso quando um campo falta ou está malformado — assim, dado ruim é barrado na porta, não lá no fundo de um sistema downstream.
Transforme payloads entre sistemas
Remodele uma requisição ou resposta com JSONata ou Handlebars — renomeie campos, reestruture objetos, enriqueça a partir de uma consulta ou converta um CSV enviado em JSON. Dois sistemas que esperam formatos diferentes se conectam sem que nenhum seja reescrito.
Traga dados com plugins de entrada
Algumas integrações começam do outro lado. Um plugin de entrada pode buscar um arquivo por FTP ou SFTP, monitorar uma pasta, consultar deltas em um ERP ou receber um webhook de parceiro — e então alimentar o que coletou no mesmo pipeline de validar, transformar e encaminhar, de modo que fontes baseadas em arquivo e em evento são tratadas como uma chamada direta.
Defina as URLs de backend uma vez
Cadastre uma URL base de backend sob uma chave e referencie-a como placeholder em endpoints e transforms. Quando um backend muda de lugar ou de versão, você edita um único base path em vez de cada endpoint que aponta para ele.
Controle o acesso com API keys
Emita API keys que carregam scopes e, quando quiser um controle mais estrito, uma lista explícita dos endpoints que podem chamar. As keys podem ser rotacionadas e desligadas, então o acesso é concedido de forma deliberada e revogado de forma limpa.
Automatize chamadas por agendamento
Vincule uma expressão CRON a um endpoint e o gateway executa todo o seu pipeline nessa cadência — ideal para importações e sincronizações recorrentes. Cada agendamento registra a hora e o status da última execução, para que uma falha silenciosa não passe despercebida.
Veja cada chamada que o gateway faz
O log de requisições lista cada chamada com seu endpoint, API key, status, latência e mensagem de erro, filtrável por key, endpoint, status e período. Quando algo quebra, você encontra a chamada com falha e a reprocessa — em até três tentativas — sem que o sistema de origem reenvie nada.
Um histórico de alterações auditável
Cada mudança de configuração — em um endpoint, key, transform, schema ou base path — é gravada em uma trilha de auditoria com o antes e o depois, o usuário responsável e o horário. Em um ambiente regulado, essa é a evidência de que sua camada de integração está sob controle.
Segurança e governança embutidas
O NEO Middleware na plataforma NEO
O NEO Middleware é onde a plataforma NEO encontra o resto dos seus sistemas. Em vez de cada módulo carregar suas próprias integrações, eles passam por um único gateway governado: NEO FLOW, NEO EBR e NEO TASK trocam dados com o seu ERP, LIMS e APIs de parceiros por meio de endpoints definidos aqui.
Como cada chamada é validada, transformada, registrada e auditada em um só lugar, a própria camada de integração passa a fazer parte da sua conformidade digital — rastreável e sob controle, em vez de um conjunto de scripts que ninguém consegue explicar por completo.
Para quem é o NEO Middleware
- Um lugar para cada conexãoCadastre, altere e desative integrações a partir de um único painel, com base paths para definir uma URL de backend uma vez e reutilizá-la em todo lugar.
- Sincronizações automáticas e confiáveisAgende importações e sincronizações recorrentes, acompanhe-as nos logs e reprocesse uma chamada com falha sem pedir que o sistema de origem reenvie.
- Uma camada de integração rastreávelCada mudança de configuração fica registrada em uma trilha de auditoria com o antes e o depois, apoiando a rastreabilidade que um ambiente regulado espera.
Perguntas frequentes
Preciso escrever código para adicionar uma integração?+
Não. Uma integração é um endpoint configurado no painel — um caminho e método públicos mapeados para uma URL de backend. A validação é um JSON Schema, e as transformações de payload são declarativas, com JSONata ou Handlebars, então a maioria das integrações é configuração, não uma nova implantação.
Como os chamadores e administradores são autenticados?+
Os chamadores do gateway público apresentam uma API key que precisa ter os scopes exigidos pelo endpoint e respeitar qualquer lista de endpoints permitidos da key. Os administradores entram no painel com senha mais um código de uso único por e-mail, ou via login Microsoft/Google, e o acesso é limitado por papel.
O NEO Middleware pode se conectar a sistemas fora do NEO?+
Sim. Qualquer backend HTTP pode ser destino — ERP, SAP, LIMS ou uma API de parceiro. Base paths e transforms adaptam URLs e formatos, um plugin FTP de entrada pode buscar um arquivo antes da chamada, e um endpoint pode aceitar upload de arquivo e passá-lo por um pipeline CSV/JSON antes de encaminhar.
Ele é atrelado à suíte NEO?+
É a camada de integração da plataforma NEO, mas funciona como um gateway de uso geral. É comumente usado para conectar módulos NEO como NEO FLOW, NEO EBR e NEO TASK ao ERP, LIMS e outros sistemas da empresa, sem embutir essas integrações em cada módulo.
Em uma demonstração, cadastraremos um endpoint, validaremos e transformaremos um payload e o rotearemos para um backend — usando uma integração próxima da sua realidade, para você ver com que rapidez uma nova conexão entra no ar.