Versionamento de API: por que isso importa até pra quem não escreve uma linha de código

Quando um sistema integrado, como emissão de nota fiscal ou pagamento online, para de funcionar do nada, a causa costuma estar numa mudança de API do lado do fornecedor que ninguém na empresa percebeu que estava chegando.

O que é versionamento, em termos simples

API versionada significa que o fornecedor mantém uma versão antiga funcionando por um período, mesmo lançando uma nova, dando tempo pra quem integrou se adaptar sem quebrar do dia pra noite.

O risco de integração sem aviso

Fornecedor que não versiona ou que avisa mudança com pouca antecedência pode derrubar uma integração crítica sem qualquer sinal prévio pro cliente que depende dela.

O que perguntar antes de integrar um sistema novo

Antes de contratar um serviço que vai integrar com o sistema da empresa, vale perguntar como o fornecedor trata mudança de API e com quanto tempo de antecedência avisa descontinuação de versão antiga.

Referências

Boas práticas de avaliação de fornecedor de integração aplicadas pela FPITS em projetos de cliente.