De CSV para JSON: Trabalhando com Dados Tabulares em APIs

CSV é como o mundo dos negócios ainda movimenta dados: exportações de CRMs, extratos bancários e relatórios de estoque. JSON é o que a maioria das APIs REST e serverless espera receber. Fazer essa conversão de forma limpa economiza horas de scripts avulsos.

O formato mais comum: array de objetos

Para APIs, o formato JSON mais amigável é um array de objetos, com um objeto por linha e as chaves vindas da linha de cabeçalho:

[
  { "sku": "A-100", "qty": "12", "warehouse": "East" },
  { "sku": "B-220", "qty": "3", "warehouse": "West" }
]

Note que o CSV trabalha com strings a menos que você adicione uma etapa separada de tipagem. Sua API deve converter qty para número se necessário.

Cabeçalhos e consistência

• A primeira linha deve conter os nomes das colunas; renomeie duplicatas antes da conversão.
• Fique atento a caracteres BOM no início de exportações UTF-8 do Excel — eles podem quebrar um parser simples e transformar seu primeiro cabeçalho em \uFEFFsku.
• Campos entre aspas podem conter vírgulas e quebras de linha; parsers bem implementados lidam com isso; dividir por vírgula via regex, não.

Quando JSON → CSV

Ferramentas de relatório e anexos de e-mail frequentemente precisam de CSV novamente. Exporte uma linha por objeto; use a união de todas as chaves como colunas se os objetos forem diferentes (linhas esparsas ficam com células vazias).

Valide antes de ir para produção

Após a conversão, passe seu JSON por um JSON Formatter para detectar vírgulas finais, aspas simples ou valores NaN acidentais vindos de fórmulas de planilha.

Se o seu pipeline também aceita YAML de repositórios de configuração, o YAML to JSON pode ajudar a alinhar tudo aos mesmos testes de schema JSON.

Teste localmente

Nosso Conversor CSV ↔ JSON roda no navegador: cole uma exportação de exemplo, obtenha JSON formatado ou faça o caminho inverso para um relatório rápido. Nenhum arquivo sai do seu dispositivo.

Trate o CSV como entrada não confiável se os usuários fizerem upload — limite o tamanho, verifique injeção de fórmulas no Excel (=cmd|) e nunca execute células como código.

Resumo

• Prefira cabeçalho + linhas → array de objetos para APIs.
• Respeite as regras de aspas; evite parsers CSV feitos à mão em produção.
• Sempre valide o JSON e o schema antes de enviar para serviços downstream.