profound-logoProfound CMS
⌘K
Admin
Theme
DocsTutorialBlogPhilosophy
DocsTutorialBlogPhilosophy

Hybrid

Collection of Pages with ComponentsTypes of ComponentsSetup server sent events (SSE) content refetchInstall Profound CMS as a proxyCEL Scripting in Template BuilderProject ScaffoldingMedia Library

Headless

Quick startJSON 与 Claude 代码组件 Zod 拉取

REST API

REST API 概览get连接网站 APIgetGET /routesgetGET /routegetGET /blocksget获取带有 CEL 缓存的区块getGET /blocks/generatedgetGET /componentsgetGET /components/{name}getGET /dataset/{schema_name}get获取内容变更 SSEpatchPATCH /dataset/{schema_name}postPOST /translationpatchPATCH /translationsgetGET /usagepostPOST /csvpatch修补 CSV
All Systems Operational
Powered Byprofound-logo
Theme

POST /csv

将 CSV 或 JSON 表格行摄取为草稿文档,每行一个。

将 CSV 行(或 JSON 表格行)摄取为草稿文档,每行一个文档。

认证: Bearer JWT(WorkOS)。

查询参数

参数类型必填说明
website_iduuid是目标网站。注意:此处使用 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。每行都会成为一个草稿文档;文档标题是该行的第一个字符串值。

示例 — JSON

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"}]}'

示例 — multipart CSV

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 — 缺少或无效的 JWT
  • 500 — 插入失败
Continue Reading
Previous‹GET /usageNext修补 CSV›