将 CSV 或 JSON 表格行摄取为草稿文档,每行一个。
将 CSV 行(或 JSON 表格行)摄取为草稿文档,每行一个文档。
认证: Bearer JWT(WorkOS)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
website_id | uuid | 是 | 目标网站。注意:此处使用 snake_case,与大多数端点不同。 |
接受两种内容类型,通过 Content-Type 头进行分派。
multipart/form-data — 字段:
schema_name(文本,必填)file(原始 CSV 字节,必填)。第一行是表头;每个单元格会变成去除空白的 JSON 字符串值。application/json(最大 10 MiB):
{
"schema_name": "post",
"spreadsheet_data": [ { "title": "Row 1" }, { "title": "Row 2" } ]
}
schema_name(字符串,必填)spreadsheet_data(对象数组,必填){ "inserted": 2 }
返回 201 Created。每行都会成为一个草稿文档;文档标题是该行的第一个字符串值。
curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
-H 'Authorization: Bearer <workos-jwt>' \
-H 'Content-Type: application/json' \
-d '{"schema_name":"post","spreadsheet_data":[{"title":"Row 1"}]}'
curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
-H 'Authorization: Bearer <workos-jwt>' \
-F 'schema_name=post' \
-F 'file=@data.csv'
400 — 解析错误、缺少 schema_name/file、spreadsheet_data 不是数组、行不是对象,或 CSV 为空401 — 缺少或无效的 JWT500 — 插入失败