Colocando JSON em sistemas reais: como definir contratos de API, como gerenciar configuração e fixtures, como lidar com compatibilidade de versão e como manter dados de teste.
5 artigosSeis coisas são muito difíceis de mudar depois de publicadas: envelopes de resposta, formatos de erro, formato de paginação, representação de IDs e tempo, a semântica de null versus ausente e a evolução de versão.
A configuração precisa ser em camadas e validada; as fixtures precisam ser determinísticas, legíveis e comparáveis por diff. Se esses dois tipos de arquivo forem mal administrados, o custo de depuração fica alto por muito tempo.
Cinquenta registros viram cinquenta e um e o diff acusa cinquenta e uma mudanças. Cobre falsos positivos de diff de texto, casamento de arrays por id, normalização com jq e patches aplicáveis.
merge=union deixa JSON quebrado passar e ainda relata sucesso. Este artigo percorre um driver de merge de três vias ciente de chaves para JSON, além de três hábitos que reduzem conflitos.
Adicionar um campo não é automaticamente seguro. Cobre fronteiras de compatibilidade, campos de versão, janelas de depreciação, migração com gravação dupla, testes de contrato e métricas de canário.
