Mudar a API sem quebrar quem já integrou com você

Renomear o campo valor na resposta de uma API sem aviso derruba a integração do parceiro que já vende por você, e o chamado chega ao comercial antes de chegar à engenharia.

Backend é a retaguarda do produto, onde ficam as regras, o estoque e o dinheiro, e a API é o balcão pelo qual outro sistema conversa com essa retaguarda, sem passar pela tela.

O contrato da API é a lista do que ela aceita receber e do que promete devolver, com nome de campo, formato e código de resposta. Quem escreve o contrato define o custo do outro lado.

Campo novo na resposta passa despercebido, porque quem não conhece esse campo simplesmente o ignora. Renomear ou remover um campo já lido tira o nome do lugar onde o parceiro esperava encontrá-lo, e a integração dele quebra na primeira chamada depois da publicação.

Tratar toda mudança como quebra de contrato também sai caro, porque se cada campo novo exigisse meses de aviso a API pararia de evoluir. O critério é simples: algo que existia deixou de existir, ou mudou de significado.

Duas escolhas de bastidor aparecem em toda proposta e merecem sua atenção. A primeira é a versão do runtime, o programa que executa o código do servidor. Em setembro de 2026, o que vai para produção é o Node.js 24, a linha com suporte de longo prazo ativo; o Node.js 26 existe, e ainda é a linha corrente.

A segunda é a linguagem. O TypeScript 7.0 virou programa nativo, e a checagem de tipos de um projeto grande caiu de 125,7 para 10,6 segundos. Isso é tempo de esteira de publicação, e tempo de esteira aparece na fatura todo mês.

Uma categoria nova entrou nas propostas de 2026: a execução durável, tarefa que sobrevive a queda de servidor e retoma do ponto onde parou. Fila resolve desacoplamento, isto é, aceitar o pedido agora e processar depois; execução durável resolve retomada, e pesa em produto com IA, onde falhar no meio significa pagar duas vezes pelo mesmo trabalho.

A versão do runtime entra na conversa de risco, porque é ela que define até quando o servidor recebe correção de segurança. Essa data entra no plano de atualização e no contrato com o fornecedor: software parado na versão errada vira exposição sem aviso prévio.

Antes de aprovar o próximo orçamento de engenharia, peça a lista de quem consome cada endereço da API e o prazo de aviso combinado para remover um campo. Confirme também a data em que a versão do runtime em produção perde suporte de segurança.