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

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": "ํฌ์ŠคํŠธ",
  "spreadsheet_data": [ { "title": "ํ–‰ 1" }, { "title": "ํ–‰ 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":"ํฌ์ŠคํŠธ","spreadsheet_data":[{"title":"ํ–‰ 1"}]}'

์˜ˆ์‹œ โ€” multipart CSV

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -F 'schema_name=ํฌ์ŠคํŠธ' \
  -F 'file=@data.csv'

์˜ค๋ฅ˜

  • 400 โ€” ๊ตฌ๋ฌธ ์˜ค๋ฅ˜, schema_name/file ๋ˆ„๋ฝ, ๋ฐฐ์—ด์ด ์•„๋‹Œ spreadsheet_data, ๊ฐ์ฒด๊ฐ€ ์•„๋‹Œ ํ–‰, ๋˜๋Š” ๋น„์–ด ์žˆ๋Š” CSV
  • 401 โ€” JWT๊ฐ€ ์—†๊ฑฐ๋‚˜ ์œ ํšจํ•˜์ง€ ์•Š์Œ
  • 500 โ€” ์‚ฝ์ž… ์‹คํŒจ
Continue Reading
Previousโ€น์‚ฌ์šฉ๋Ÿ‰ ๊ฐ€์ ธ์˜ค๊ธฐNextPATCH /csvโ€บ