POST /csv

استيعاب صفوف CSV أو صفوف جدول بيانات JSON كوثائق مسودة، واحدة لكل صف.

استوعب صفوف CSV (أو صفوف جدول بيانات JSON) كوثائق مسودة، وثيقة واحدة لكل صف.

المصادقة: رمز JWT من نوع Bearer (WorkOS).

معاملات الاستعلام

المعامل	النوع	مطلوب	ملاحظات
`website_id`	uuid	نعم	موقع الويب المستهدف. ملاحظة: صيغة snake_case هنا، على عكس معظم نقاط النهاية.

جسم الطلب

يتم قبول نوعين من المحتوى، ويتم التمييز بينهما عبر ترويسة Content-Type.

multipart/form-data — الحقول:

schema_name (نص، مطلوب)
file (بايتات CSV خام، مطلوب). الصف الأول عبارة عن رؤوس؛ كل خلية تصبح قيمة سلسلة JSON مشذَّبة.

application/json (بحد أقصى 10 ميبيبايت):

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

مثال — 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 — فشل في الإدراج

Previous‹الحصول على الاستخدام NextPATCH /csv›

المعامل

النوع

مطلوب

ملاحظات

website_id

uuid

نعم

موقع الويب المستهدف. ملاحظة: صيغة snake_case هنا، على عكس معظم نقاط النهاية.

جسم الطلب

يتم قبول نوعين من المحتوى، ويتم التمييز بينهما عبر ترويسة Content-Type.

multipart/form-data — الحقول:

schema_name (نص، مطلوب)

file (بايتات CSV خام، مطلوب). الصف الأول عبارة عن رؤوس؛ كل خلية تصبح قيمة سلسلة JSON مشذَّبة.

application/json (بحد أقصى 10 ميبيبايت):

{
  "schema_name": "منشور",
  "spreadsheet_data": [ { "title": "الصف 1" }, { "title": "الصف 2" } ]
}

schema_name (سلسلة، مطلوب)

spreadsheet_data (مصفوفة من الكائنات، مطلوب)

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