JSON 转 CSV API

JSON 转 CSV API 调用示例

选择语言，在环境变量中设置 TABLECONVERT_API_KEY 后运行请求。各示例均将 CSV 响应保存为 output.csv。

curl --fail-with-body --max-time 40 \
  'https://api.tableconvert.com/v2/convert/json-to-csv' \
  --header "Authorization: Bearer $TABLECONVERT_API_KEY" \
  --form-string 'data=[{"name":"Alice","email":"alice@example.com","active":true},{"name":"Bob","email":"bob@example.com","active":false}]' \
  --output output.csv

import json
import os
from pathlib import Path
import requests

rows = [
    {"name": "Alice", "email": "alice@example.com", "active": True},
    {"name": "Bob", "email": "bob@example.com", "active": False},
]

response = requests.post(
    "https://api.tableconvert.com/v2/convert/json-to-csv",
    headers={
        "Authorization": f"Bearer {os.environ['TABLECONVERT_API_KEY']}"
    },
    files={"data": (None, json.dumps(rows))},
    timeout=40,
)
response.raise_for_status()
Path("output.csv").write_bytes(response.content)

import { writeFile } from "node:fs/promises";

const rows = [
  { name: "Alice", email: "alice@example.com", active: true },
  { name: "Bob", email: "bob@example.com", active: false },
];

const form = new FormData();
form.set("data", JSON.stringify(rows));

const response = await fetch(
  "https://api.tableconvert.com/v2/convert/json-to-csv",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer " + process.env.TABLECONVERT_API_KEY,
    },
    body: form,
    signal: AbortSignal.timeout(40_000),
  },
);

if (!response.ok) {
  throw new Error("HTTP " + response.status + ": " + await response.text());
}
await writeFile("output.csv", Buffer.from(await response.arrayBuffer()));

请求参数

使用 multipart/form-data 发送请求，从 data、file、url 中选择一种输入来源。不要手动设置 Content-Type，请由 HTTP 客户端生成 multipart boundary。

三种输入任选其一

CSV 输出选项

通过以下可选表单字段控制 CSV 输出。这里的默认值与本页示例一致。

嵌套 JSON 与字段映射

此接口用于转换表格记录。从 API、数据库或应用导出数据前，请核对以下映射规则。

需要提取嵌套 JSON 中的字段？

发送请求前，先准备好需要的列。下例将 profile.city 提取为 city 列，无需添加不存在的 flatten 参数。

const records = [
  { name: "Alice", profile: { city: "London" } },
];

const rows = records.map(({ name, profile }) => ({
  name,
  city: profile.city,
}));
// Send JSON.stringify(rows) in the data form field.

响应与错误处理

保存响应前先检查 HTTP 状态码。v2 成功响应使用 text/plain；错误响应正文包含纯文本消息。

大小限制与用量

文件上传最大为 50 MiB（52,428,800 字节）。multipart 中单个文本字段最大为 1 MiB；较大的 JSON 请使用文件上传。v2 的服务端处理期限为 30 秒。

标准 JSON 转 CSV 请求每次成功消耗 1 积分，失败或超时后释放预留积分。历史账户条款可能不同，请查看账户与当前定价。

接入前的常见问题