POST /csv

Nhập các hàng CSV (hoặc các hàng bảng tính JSON) thành tài liệu nháp, mỗi tài liệu cho mỗi hàng.

Xác thực: Bearer JWT (WorkOS).

Tham số truy vấn

Thân yêu cầu

Hai loại nội dung được chấp nhận, xác định qua header Content-Type.

multipart/form-data — các trường:

• schema_name (văn bản, bắt buộc)
• file (dữ liệu thô CSV, bắt buộc). Hàng đầu tiên là tiêu đề; mỗi ô sẽ trở thành một giá trị chuỗi JSON đã được cắt gọn.

application/json (tối đa 10 MiB):

{
  "schema_name": "bài đăng",
  "spreadsheet_data": [ { "title": "Hàng 1" }, { "title": "Hàng 2" } ]
}

• schema_name (chuỗi, bắt buộc)
• spreadsheet_data (mảng các đối tượng, bắt buộc)

Phản hồi

{ "inserted": 2 }

Trả về 201 Created. Mỗi hàng trở thành một tài liệu nháp; tiêu đề tài liệu là giá trị chuỗi đầu tiên của hàng đó.

Ví dụ — JSON

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"schema_name":"bài đăng","spreadsheet_data":[{"title":"Hàng 1"}]}'

Ví dụ — multipart CSV

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -F 'schema_name=bài đăng' \
  -F 'file=@data.csv'

Lỗi

• 400 — lỗi phân tích, thiếu schema_name/file, spreadsheet_data không phải mảng, hàng không phải đối tượng hoặc CSV rỗng
• 401 — thiếu hoặc JWT không hợp lệ
• 500 — chèn thất bại