Files
SnapOtter/apps/docs/pt-BR/tools/files/csv-json.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Converta entre CSV e JSON, em ambas as direções. 978c08ad46d3 human aa409fc0e337

CSV para JSON

Converta entre os formatos CSV e JSON em ambas as direções. Envie um arquivo CSV ou TSV para obter um array JSON de objetos, ou envie um array JSON para obter um arquivo CSV.

Endpoint da API

POST /api/v1/tools/files/csv-json

Aceita dados de formulário multipart com um arquivo CSV, TSV ou JSON e um campo JSON settings.

Parâmetros

Parâmetro Tipo Obrigatório Padrão Descrição
pretty boolean Não true Formatar a saída JSON de forma legível, com indentação

Exemplo de Requisição

CSV para JSON:

curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@users.csv" \
  -F 'settings={"pretty": true}'

JSON para CSV:

curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@users.json" \
  -F 'settings={}'

Exemplo de Resposta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
  "originalSize": 1500,
  "processedSize": 2200
}

Notas

  • A direção da conversão é detectada automaticamente pela extensão do arquivo de entrada: .csv ou .tsv produz .json, e .json produz .csv.
  • O parâmetro pretty afeta apenas a saída JSON. Quando definido como false, a saída é uma string JSON compacta de linha única.
  • A entrada JSON deve ser um array de objetos com chaves consistentes. Cada objeto se torna uma linha, e cada chave se torna um cabeçalho de coluna.
  • Arquivos TSV (valores separados por tabulação) são suportados junto com CSV.