profound-logoProfound CMS
⌘K
Admin
Theme
Docsبرنامج تعليميBlogPhilosophy
Docsبرنامج تعليميBlogPhilosophy

Hybrid

التوجيه البارامتريTypes of Componentsإس إس إيInstall Profound CMS as a proxyالبرمجة النصية في منشئ القوالبProject Scaffoldingمكتبة الوسائط

بلا رأس

البدء السريعJSON و Claude CodeComponent Zod Pull

واجهة برمجة تطبيقات REST

نظرة عامة على واجهة RESTgetربط موقع الويب بواجهة برمجة التطبيقاتgetالحصول على المساراتgetالحصول على مسارgetالحصول على الكتلgetجلب الكتل مع ذاكرة CEL المؤقتةgetGET /blocks/generatedgetالحصول على المكوناتgetGET /components/{name}getالحصول على اسم مخطط مجموعة البياناتgetالحصول على تغييرات المحتوى (SSE)patchPATCH /dataset/{schema_name}postترجمة المنشورpatchPATCH /translationsgetالحصول على الاستخدامpostPOST /csvpatchPATCH /csv
All Systems Operational
Powered Byprofound-logo
Theme

PATCH /csv

حدّث الحقول في صف مصدر CSV موجود يملكه صاحب الطلب.

حدّث الحقول في صف موجود ضمن csv_sources يملكه المستخدم الذي يقوم بالاستدعاء.

المصادقة: رمز Bearer JWT (WorkOS). التحديث محصور بمستخدمك (ادعاء sub)، لذا لا يمكنك تعديل سوى مصادر CSV الخاصة بك.

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

المعاملالنوعمطلوبملاحظات
iduuidنعممعرّف صف csv_sources.

جسم الطلب

{
  "schema_name": "منشور",
  "spreadsheet_data": [ { "title": "الصف 1" } ],
  "status": "جاهز"
}
الحقلالنوعمطلوبملاحظات
schema_namestringلااسم المخطط الجديد.
spreadsheet_dataarrayلايستبدل raw_data؛ يضبط row_count على طول المصفوفة.
statusstringلاالحالة الجديدة.

جميع الحقول الثلاثة اختيارية، ولكن يجب توفير واحد على الأقل.

الاستجابة

الصف المحدَّث بالكامل:

{
  "id": "...",
  "user_id": "...",
  "schema_name": "منشور",
  "file_name": "بيانات.csv",
  "file_url": null,
  "raw_data": [],
  "row_count": 1,
  "status": "جاهز",
  "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":"جاهز"}'

الأخطاء

  • 400 — لم يتم توفير حقول قابلة للتحديث
  • 401 — مطالبة sub مفقودة أو رمز JWT غير صالح
  • 404 — لا يوجد صف مطابق لـ id + مستخدمك
  • 500 — فشل في التحديث
Continue Reading
Previous‹POST /csv