profound-logoProfound CMS
โŒ˜K
Admin
Theme
DocsTutorialBlogPhilosophy
DocsTutorialBlogPhilosophy

Hybrid

Collection of Pages with Components๊ตฌ์„ฑ ์š”์†Œ ์œ ํ˜•Setup server sent events (SSE) content refetch์–ด๋“œ๋ฏผ ํŒจ๋„ ํ”„๋ก์‹œ ์„ค์ •ํ…œํ”Œ๋ฆฟ ๋นŒ๋”์—์„œ ์Šคํฌ๋ฆฝํŒ…Project Scaffolding๋ฏธ๋””์–ด ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

Headless

Quick startjson๊ณผ Claude ์ฝ”๋“œ์ปดํฌ๋„ŒํŠธ Zod ๊ฐ€์ ธ์˜ค๊ธฐ

REST API

REST API ๊ฐœ์š”get์›น์‚ฌ์ดํŠธ๋ฅผ CMS API์— ์—ฐ๊ฒฐํ•˜๊ธฐget๊ฒฝ๋กœ ๊ฐ€์ ธ์˜ค๊ธฐget๋ผ์šฐํŠธ ๊ฐ€์ ธ์˜ค๊ธฐget๋ธ”๋ก ๊ฐ€์ ธ์˜ค๊ธฐgetCEL ์บ์‹œ๊ฐ€ ํฌํ•จ๋œ ๋ธ”๋ก ๊ฐ€์ ธ์˜ค๊ธฐget๋ธ”๋ก ์ƒ์„ฑ ๊ฐ€์ ธ์˜ค๊ธฐget์ปดํฌ๋„ŒํŠธ ๊ฐ€์ ธ์˜ค๊ธฐgetGET /components/{name}get๋ฐ์ดํ„ฐ์…‹ ์Šคํ‚ค๋งˆ ์ด๋ฆ„ ๊ฐ€์ ธ์˜ค๊ธฐgetGET /content-changes (SSE)patchPATCH /dataset/{schema_name}post๊ฒŒ์‹œ๋ฌผ ๋ฒˆ์—ญpatch๋ฒˆ์—ญ ํŒจ์น˜get์‚ฌ์šฉ๋Ÿ‰ ๊ฐ€์ ธ์˜ค๊ธฐpostPOST /csvpatchPATCH /csv
All Systems Operational
Powered Byprofound-logo
Theme

PATCH /csv

ํ˜ธ์ถœ์ž๊ฐ€ ์†Œ์œ ํ•œ ๊ธฐ์กด CSV ์†Œ์Šค ํ–‰์˜ ํ•„๋“œ๋ฅผ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค.

ํ˜ธ์ถœํ•œ ์‚ฌ์šฉ์ž๊ฐ€ ์†Œ์œ ํ•œ ๊ธฐ์กด csv_sources ํ–‰์˜ ํ•„๋“œ๋ฅผ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค.

์ธ์ฆ: Bearer JWT(WorkOS). ์—…๋ฐ์ดํŠธ ๋ฒ”์œ„๋Š” ์‚ฌ์šฉ์ž์˜ sub ํด๋ ˆ์ž„์œผ๋กœ ์ œํ•œ๋˜๋ฏ€๋กœ, ๋ณธ์ธ ์†Œ์œ ์˜ CSV ์†Œ์Šค๋งŒ ์ˆ˜์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜

๋งค๊ฐœ๋ณ€์ˆ˜์œ ํ˜•ํ•„์ˆ˜๋น„๊ณ 
iduuid์˜ˆcsv_sources ํ–‰ ID์ž…๋‹ˆ๋‹ค.

์š”์ฒญ ๋ณธ๋ฌธ

{
  "schema_name": "post",
  "spreadsheet_data": [ { "title": "ํ–‰ 1" } ],
  "status": "ready"
}
ํ•„๋“œ์œ ํ˜•ํ•„์ˆ˜๋น„๊ณ 
schema_namestring์•„๋‹ˆ์š”์ƒˆ๋กœ์šด ์Šคํ‚ค๋งˆ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.
spreadsheet_dataarray์•„๋‹ˆ์š”raw_data๋ฅผ ๋Œ€์ฒดํ•˜๊ณ , ๋ฐฐ์—ด ๊ธธ์ด๋กœ row_count๋ฅผ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
statusstring์•„๋‹ˆ์š”์ƒˆ๋กœ์šด ์ƒํƒœ์ž…๋‹ˆ๋‹ค.

์„ธ ํ•„๋“œ ๋ชจ๋‘ ์„ ํƒ ์‚ฌํ•ญ์ด์ง€๋งŒ, ์ตœ์†Œ ํ•˜๋‚˜๋Š” ์ œ๊ณตํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์‘๋‹ต

์ „์ฒด ์—…๋ฐ์ดํŠธ๋œ ํ–‰:

{
  "id": "...",
  "user_id": "...",
  "schema_name": "post",
  "file_name": "data.csv",
  "file_url": null,
  "raw_data": [],
  "row_count": 1,
  "status": "ready",
  "error_msg": null,
  "created_at": "2026-06-23T18:34:16Z",
  "updated_at": "2026-06-23T20:36:55Z"
}

์˜ˆ์‹œ

curl -X PATCH '{CMS_API_URL}/csv?id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"status":"ready"}'

์˜ค๋ฅ˜

  • 400 โ€” ์—…๋ฐ์ดํŠธํ•  ํ•„๋“œ๊ฐ€ ์ œ๊ณต๋˜์ง€ ์•Š์Œ
  • 401 โ€” sub ํด๋ ˆ์ž„ ๋ˆ„๋ฝ ๋˜๋Š” ์ž˜๋ชป๋œ JWT
  • 404 โ€” id์™€ ์‚ฌ์šฉ์ž์— ํ•ด๋‹นํ•˜๋Š” ํ–‰์ด ์—†์Œ
  • 500 โ€” ์—…๋ฐ์ดํŠธ ์‹คํŒจ
Continue Reading
Previousโ€นPOST /csv