นำเข้าแถว CSV หรือแถวสเปรดชีต JSON เป็นเอกสารฉบับร่างทีละแถว
นำเข้าแถว CSV (หรือแถวสเปรดชีต JSON) เป็นเอกสาร ฉบับร่าง ทีละแถว
การยืนยันตัวตน: Bearer JWT (WorkOS).
| พารามิเตอร์ | ชนิด | จำเป็น | หมายเหตุ |
|---|---|---|---|
website_id | uuid | yes | เว็บไซต์เป้าหมาย หมายเหตุ: ใช้ 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 — ไม่มี JWT หรือ JWT ไม่ถูกต้อง500 — แทรกข้อมูลล้มเหลว