Software e IA para executivos · Capítulo 10 de 41 · 6 min
Mudar a API sem derrubar o parceiro
Renomear um campo sem aviso derruba o parceiro que já vende por você. Separe a mudança inofensiva da que quebra a integração.
Este capítulo faz parte do curso gratuito Software e IA para executivos.
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.
- Contrato da API
O que ela aceita e o que promete devolver, campo a campo.
- Campo novo
Passa despercebido por quem já integrou.
- Campo renomeado
Quebra a integração do parceiro na primeira chamada.
- Runtime com data
O Node.js 24 está em manutenção desde 20/10/2026; o 26 vira Active LTS em 28/10/2026.
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.

Fonte: OpenAPI Initiative · Captura em 24/10/2026.
Ver como texto
Especificação OpenAPI 3.2.0 com o sumário à esquerda e, à direita, a data de publicação de 19 de setembro de 2025, os links e os editores
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. O Node.js 24 entrou em manutenção em 20/10/2026 e recebe correção até 30/04/2028. O Node.js 26 passa a Active LTS, a linha de suporte ativo, em 28/10/2026, e é nela que projeto novo deve nascer; o 22 recebe correção até 30/04/2027.
O calendário também muda de forma. A partir do Node.js 27, com versão alpha prevista para 28/10/2026, cada linha passa por alpha, vira LTS e fica 30 meses em suporte ativo, sem a fase de manutenção. O plano de atualização fica mais previsível, desde que alguém anote as datas.

Ver como texto
Tabela de calendário de versões do Node.js no GitHub, com as linhas 22, 24, 26 e 27, o status de cada uma e as datas de início de fase e de fim de vida
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.

Ver como texto
Anúncio do TypeScript 7.0 no blog da Microsoft, publicado em 8 de julho de 2026, que apresenta uma versão nativa dez vezes mais rápida
As propostas de 2026 também trazem uma linha nova, a execução durável, tarefa que sobrevive a queda de servidor e retoma do ponto onde parou. Ela mora no capítulo sobre o que roda em segundo plano, que explica quando ela compensa e quando a fila simples basta.
| Camada | Escolha dominante | Quando trocar |
|---|---|---|
| Runtime | Node.js 26, Active LTS a partir de 28/10/2026; o Node.js 24 está em Maintenance LTS desde 20/10/2026, com suporte até 30/04/2028 | Bun 1.4 para CLI e scripts; Deno para edge com TypeScript nativo |
| Framework | Next.js API Routes, Fastify, Hono | Express apenas em legado |
| Linguagem | TypeScript 7.0, compilador nativo em Go desde 08/07/2026 | Go ou Rust quando latência abaixo de 10 ms importa |
| Validação | Zod | Yup apenas em app React Native legado |
| ORM | Drizzle, Prisma | TypeORM está em queda |
| Banco | Postgres, via Supabase ou Neon | SQLite com Turso para edge |
| Cache | Redis, via Upstash | Cloudflare KV para edge |
| Filas e execução durável | BullMQ com Redis e Cloudflare Queues para fila; Trigger.dev, Inngest ou Vercel Workflow quando a tarefa precisa retomar de onde parou | SQS em ambiente AWS-heavy |
| Auth | Clerk, Auth.js, Supabase Auth | Solução própria apenas com requisito muito específico |
| Hospedagem | Vercel, Cloudflare Workers, Fly.io | AWS ou GCP em enterprise |
O calendário do Node.js muda a partir da versão 27: sai uma versão principal por ano, em abril, e cada uma entra em LTS em outubro do mesmo ano, segundo o calendário oficial consultado em 23/10/2026. O que vai para produção é sempre uma linha LTS. A linha de filas ganhou a execução durável porque fila resolve desacoplamento e execução durável resolve retomada de estado, categoria que cresceu em 2026 com agente de IA rodando por minutos.
Fonte: Stack Overflow Developer Survey, JetBrains Developer Ecosystem Report e telemetria pública da Vercel, conforme citado no curso.
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.
Na próxima revisão de orçamento de engenharia, leve duas perguntas. Quem consome cada endereço da API, e com qual prazo de aviso combinado para remover um campo? Em que data a versão do runtime em produção perde suporte de segurança?
- 06/10/2026 · Next.js
Sai a versão 16.4, da linha 16, que está em Active LTS; a linha 15 segue só com correção.
- 14/10/2026 · Next.js
As versões 16.4.1 e 15.5.28 fecham duas falhas críticas de execução remota de código vindas de dependências.
- 15/10/2026 · PostgreSQL
O Postgres 19 entra em release candidate.
- 20/10/2026 · Node.js
O Node.js 24 passa para Maintenance LTS e só recebe correção até 30/04/2028.
- 28/10/2026 · Node.js
O Node.js 26 vira Active LTS, a linha para projeto novo, e o 27 começa em alpha.
- 10/11/2026 · Supabase
Não antes desta data, quatro cifras CBC do TLS 1.2 saem das APIs HTTP; cliente embarcado antigo pode perder a conexão.
- 12/11/2026 · PostgreSQL
Segundo release candidate do Postgres 19, junto da atualização das versões suportadas.
- 19/11/2026 · PostgreSQL
Lançamento final previsto do Postgres 19.
Cada data vira linha no plano de atualização: versão em uso, data em que perde correção e responsável pela troca.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Node.js: JavaScript no ServidorNode.js: executar JavaScript fora do navegadorExaminar conexões de Node.js: executar JavaScript fora do navegador
- Publicar com Vercel e CloudflareComo acompanhar mudanças e fim de suporteExaminar conexões de Como acompanhar mudanças e fim de suporte
- Frontends com VibecodingEscolher a stack e projetar suas dependênciasExaminar conexões de Escolher a stack e projetar suas dependências
- API Design: REST, GraphQL e o contrato com o fornecedorComo o fornecedor muda a API sem quebrar a suaExaminar conexões de Como o fornecedor muda a API sem quebrar a sua
Terminou a leitura?
Você está aqui: capítulo 10 de 41
0 de 41 concluídos
- Próximo · Capítulo 11 de 41 · 6 minQuem consome a API escolhe o formatoLer o capítulo 11 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 9 de 41 · 7 minA velocidade que o cliente sente no celularVoltar para o capítulo 9
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Software e IA para executivos
- 08Em que momento a página fica pronta, e quanto custa
- 09A velocidade que o cliente sente no celular
- 10Mudar a API sem derrubar o parceiro
- 11Quem consome a API escolhe o formato
- 12Ler o código de erro antes de procurar culpado