Integrações e APIs entre sistemas

Para quem faz sentido

• A mesma informação é digitada em mais de um sistema.
• Existe uma exportação manual que se repete toda semana.
• Um sistema novo precisa conversar com o que já está em uso.
• É preciso expor dados ou funcionalidades para um parceiro ou outra aplicação.

Problemas que resolvemos

• Trabalho manual entre sistemas

  Copiar informação de um lugar para outro funciona até o dia em que alguém erra, esquece ou sai de férias. É o primeiro candidato a virar integração, porque o custo já existe — só não aparece numa fatura.

• Dados que discordam entre si

  Sem definir qual sistema é dono de cada informação, sincronizar apenas espalha a divergência mais rápido. A integração começa por essa decisão, não pelo código.

• Integração que quebra em silêncio

  Sistemas externos saem do ar, mudam contrato e recusam requisições. Sem repetição controlada, registro e alerta, a falha só é descoberta quando alguém dá falta do dado — normalmente tarde.

• Acesso sem limite claro

  Uma API exposta precisa saber quem está chamando, o que aquela chamada pode acessar e a que ritmo. Autenticação, escopo e limite fazem parte do desenho, não de uma etapa posterior.

O que construímos

• APIs REST próprias
• Integração com sistemas e plataformas existentes
• Webhooks e fluxos orientados a evento
• Sincronização entre bases de dados
• Autenticação e controle de acesso entre serviços

Como construímos

• Primeiro, quem é dono do dado

  Antes de qualquer integração, definimos onde cada informação nasce e quem pode alterá-la. Sem isso, os dois sistemas passam a se sobrescrever e o problema fica pior do que era com o trabalho manual.

• Contratos explícitos

  O que entra, o que sai, o que é obrigatório e o que acontece quando um campo muda. Um contrato claro é o que permite os dois lados evoluírem sem combinar cada alteração por conversa.

• Falha é caso previsto, não exceção

  Tentativa repetida com intervalo crescente, operações que podem ser reexecutadas sem duplicar efeito, e uma fila para o que não passou. O objetivo é que uma indisponibilidade de vinte minutos não vire perda de dado.

• Observável desde o primeiro dia

  Registro do que foi enviado, do que foi recebido e do que falhou. Uma integração que não se pode inspecionar é uma caixa-preta no meio da operação.

Tecnologias

O que usamos hoje em produção nesse tipo de trabalho:

Onde atuamos

Relacionado

Perguntas frequentes

• Quando vale a pena integrar dois sistemas?

  Quando a mesma informação precisa existir nos dois e alguém está mantendo isso à mão com frequência. Se a transferência é rara e simples, integrar pode custar mais do que resolve — e dizer isso faz parte do trabalho.

• API e integração são a mesma coisa?

  Não. A API é a interface que um sistema oferece para ser usado por outro. A integração é o trabalho de ligar os dois de forma confiável: autenticação, formato, ritmo, e o que fazer quando um dos lados não responde.

• É possível integrar sistemas antigos?

  Quase sempre. Quando não existe API, restam outros caminhos: banco de dados, arquivos ou uma camada intermediária que traduz entre os dois. O que muda é o esforço e o quanto dá para garantir em tempo real.