Converter JSON para CSV

Este conversor rigoroso usa as chaves do primeiro objeto como cabeçalho, verifica se todos os objetos têm exatamente as mesmas chaves e trata vírgulas, aspas e quebras de linha segundo as regras padrão de CSV. Arrays vazios, valores aninhados, JSON inválido e registros incompatíveis geram um erro claro, não uma planilha ambígua. A mesma conversão determinística está disponível no navegador e pela API.

Prepare um array uniforme de objetos simples

Comece com um JSON válido cujo valor no nível superior seja um array. Cada item deve ser um objeto, e cada valor de campo deve ser um escalar JSON: string, número, booleano ou null. Objetos e arrays aninhados são rejeitados de propósito porque não existe uma única maneira correta de colocá-los em uma célula CSV. Alguns conversores transformam valores aninhados em texto; outros achatam caminhos ou multiplicam linhas, e cada escolha altera o significado dos dados. Esta ferramenta permanece previsível ao exigir que o formato tabular esteja explícito antes da conversão. O array precisa conter pelo menos um objeto, e o primeiro objeto deve ter pelo menos uma chave. A ordem das chaves dele vira a ordem das colunas do CSV, então organize esse primeiro registro conforme você deseja ver a planilha. A ordem das chaves do objeto JSON é preservada. Os valores podem conter vírgulas, aspas, retornos de carro ou quebras de linha; você não precisa fazer o escape manual para CSV, pois o serializador cuida disso depois de analisar o JSON.

Entenda a validação rigorosa de cabeçalhos e linhas

A linha de cabeçalho é criada somente a partir das chaves do primeiro objeto. Em seguida, cada objeto restante é comparado com esse cabeçalho como um conjunto completo de chaves. Um registro com uma chave ausente falha, e um registro com uma chave extra também falha, mesmo que o valor adicional esteja vazio ou seja null. A ordem das chaves nos objetos seguintes não importa: os valores sempre são emitidos na ordem das colunas do primeiro objeto. Essa verificação rigorosa evita uma categoria sutil de erros de exportação. Um conversor permissivo pode criar uma união crescente de colunas, deixar espaços vazios sem explicação ou deslocar dados conforme o registro que introduziu uma propriedade. Aqui, a entrada irregular para com um erro que identifica o item incompatível. null é aceito como valor simples intencional e vira uma célula CSV vazia. Chaves ausentes não são tratadas como null porque ausência e null explícito podem representar estados diferentes no sistema de origem. Valide ou normalize registros irregulares antes de enviar o resultado uniforme.

Use o CSV com segurança em planilhas e fluxos

Após a validação, cada cabeçalho e valor é serializado como uma célula CSV. Células com vírgula, aspas, retorno de carro ou quebra de linha são envolvidas por aspas duplas, e as aspas internas são duplicadas. Números e booleanos usam sua representação textual JSON, enquanto null produz uma célula vazia. O resultado contém uma linha de cabeçalho seguida de uma linha por objeto, unidas por caracteres de nova linha. Como o algoritmo é determinístico e não usa rede, relógio, aleatoriedade, modelo ou serviço externo, entradas idênticas produzem saídas idênticas. Isso o torna adequado para testes, exportações agendadas, etapas de build e entregas repetíveis de dados. No navegador, cole o JSON e copie o CSV gerado sem enviar os dados para outro lugar. Para automatizar, chame a API pelo preço publicado de US$ 0,002 por solicitação. Salve o texto retornado com a extensão .csv e abra ou importe o arquivo configurando a vírgula como delimitador.