Conversor CSV ↔ JSON

Transforme planilhas exportadas em arrays JSON prontos para APIs, ou converta respostas JSON em CSV para abrir no Excel e no Google Sheets.

CSV

JSON

[
  {
    "id": 1,
    "nome": "Ana Souza",
    "email": "[email protected]",
    "ativo": true
  },
  {
    "id": 2,
    "nome": "Silva, João",
    "email": "[email protected]",
    "ativo": false
  }
]

Usar via API

Converte CSV em JSON ou JSON em CSV.

POSThttps://enhanced.dev.br/api/v1/convert/csv-json
Parâmetros do corpo JSON
Corpo (JSON)TipoDescrição
input *string | array | objectCSV como texto, ou JSON (texto ou valor) quando direction for json-csv.
direction"csv-json" | "json-csv"Padrão: "csv-json".
delimiter"auto" | "," | ";" | "\t" | "|"Padrão: "auto".
headerbooleanPrimeira linha do CSV é cabeçalho. Padrão: true.
typedbooleanConverte números, booleanos e null. Padrão: true.

Exemplo de requisição

curl -X POST "https://enhanced.dev.br/api/v1/convert/csv-json" \
    -H "Content-Type: application/json" \
    -d '{"input":"id,nome,ativo\n1,Ana,true\n2,João,false","direction":"csv-json"}'

Resposta

{
  "ok": true,
  "data": {
    "direction": "csv-json",
    "delimiter": ",",
    "output": [
      {
        "id": 1,
        "nome": "Ana",
        "ativo": true
      },
      {
        "id": 2,
        "nome": "João",
        "ativo": false
      }
    ]
  },
  "meta": {
    "version": "v1"
  }
}
  • Erros retornam { ok: false, error: { code, message } } com status HTTP 4xx/5xx.
  • Gratuita e sem chave de API. Limite de 120 requisições por minuto por IP.
  • CORS liberado: pode ser chamada direto do navegador em qualquer domínio.

Como usar

  1. Escolha a direção: CSV → JSON ou JSON → CSV.
  2. Cole os dados; o delimitador é detectado automaticamente (vírgula, ponto e vírgula, tab ou pipe).
  3. No CSV → JSON, defina se a primeira linha é cabeçalho e se números e booleanos devem ser inferidos.
  4. Use Inverter para converter o resultado de volta e conferir a ida e volta.
  5. Copie ou baixe o arquivo convertido.

Casos de uso

  • Importar planilhas de clientes ou produtos em seeds de banco de dados.
  • Exportar resultados de APIs para análise em planilhas.
  • Converter CSVs do Excel brasileiro, que usam ponto e vírgula como separador.
  • Gerar fixtures de testes a partir de dados tabulares.

Conceitos técnicos

RFC 4180 e campos com aspas

Campos que contêm o delimitador, aspas ou quebras de linha devem estar entre aspas duplas, e aspas internas são escritas duplicadas (""). O parser desta página implementa essas regras, incluindo quebras de linha dentro de campos e finais de linha CRLF.

Inferência de tipos

Com a opção ativada, valores como 42, 3.14, true, false e null viram tipos JSON nativos. Números com zero à esquerda (CEP 01310) e inteiros acima do limite seguro do JavaScript são mantidos como string para não perder informação.

JSON aninhado em CSV

CSV é plano. Na conversão JSON → CSV, as colunas são a união de todas as chaves dos objetos, e valores aninhados (objetos ou arrays) são serializados como JSON dentro da célula.

Perguntas frequentes

Por que o Excel abre meu CSV em uma coluna só?

No Excel configurado em português, o separador padrão é ponto e vírgula. Gere o CSV com delimitador ; para abri-lo diretamente.

Linhas com número diferente de colunas são aceitas?

Sim. Colunas ausentes ficam como string vazia; colunas extras sem cabeçalho são ignoradas no modo com cabeçalho.

Cabeçalhos duplicados ou vazios causam perda de dados?

Não. Eles são renomeados para column_N, garantindo que nenhuma coluna sobrescreva outra.

Ferramentas relacionadas