Skip to content
Tech

Por que meu contrato de API em produção só quebra de formas que meu pipeline de CI não consegue ver?

81

Oportunidade

Testes de contrato orientados ao consumidor detectam mudanças disruptivas antes do merge, mas fixam os contratos no momento do PR e não têm mecanismo para detectar a deriva semântica que se acumula em um serviço em produção após o deployment. As equipes adicionam campos não documentados em hotfixes de produção, alteram formatos de erro para desbloquear um incidente ou relaxam a validação sem tocar na especificação OpenAPI. O World Quality Report 2025 aponta a deriva não detectada de esquema de API como uma das três principais causas de incidentes em produção em sistemas distribuídos, e estima que aproximadamente 70 por cento das falhas de API em produção passaram por todas as verificações de CI. Nenhuma ferramenta atual monitora continuamente o tráfego de produção real em relação a um contrato publicado e expõe violações à medida que se acumulam, em vez de fazê-lo no momento do merge.

Por que importa

Monitorar o tráfego real em produção em relação ao contrato que você publicou fecharia a última milha entre o que sua API promete e o que ela silenciosamente parou de entregar.

Como avalio a oportunidade

A Pontuação de Oportunidade é minha própria leitura, não uma medição: o quanto dói, com que frequência aparece e o quanto pouco existe para resolvê-lo hoje. Quanto maior, mais vale a pena construir, na minha opinião.

Gravidade8/10

O quanto de dor causa quando aparece.

Frequência8/10

Com que frequência as pessoas realmente se deparam com isso.

Lacuna7/10

O quanto pouco de boas ferramentas existe para isso hoje.

Mais problemas que merecem ser resolvidos