Lição 4

CSV para JSON em fixtures de API

Transforme amostras de planilha em objetos JSON para mocks, testes e documentação.

CSV é como dados de amostra costumam chegar. JSON é como desenvolvedores costumam precisar usá-los.

Para mocks de API, testes e documentação, uma linha de cabeçalho mapeia bem para chaves de objeto JSON:

id,name,active
1,Ada,true
[
  {
    "id": 1,
    "name": "Ada",
    "active": true
  }
]

Inferência de tipo é uma escolha

Transformar "1" em 1 e "true" em true ajuda em fixtures. Mas é perigoso para:

  • IDs de conta com zeros à esquerda
  • CEP ou códigos postais
  • Identificadores numéricos grandes
  • Códigos que parecem número mas são string

Desative inferência de tipo quando o texto exato importa.

Checklist de fixture de API

  • Use nomes de cabeçalho estáveis que batam com o contrato da API.
  • Mantenha poucas linhas em testes unitários.
  • Preserve strings quando IDs ou códigos precisam de formatação exata.
  • Valide o JSON final com formatador ou schema quando o payload importa.

Conclusão

CSV → JSON não é só troca de formato. É decisão de schema: chaves, tipos, nulos e arrays devem combinar com a API alvo.

Use o Conversor CSV para JSON / JSON para CSV com inferência de tipos ligada e desligada para comparar a saída de fixtures.

Voltar à visão geral do curso