تقسيم CSV

قسّم ملف CSV أو TSV كبيرًا إلى ملفات أصغر حسب عدد الصفوف. تُرجع أرشيف ZIP يحتوي على الأجزاء.

نقطة نهاية API

POST /api/v1/tools/files/split-csv

يقبل بيانات نموذج متعدّد الأجزاء (multipart) مع ملف CSV وحقل settings بصيغة JSON.

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
rowsPerFile	integer	لا	1000	عدد صفوف البيانات لكل ملف مخرَج (1-1,000,000)
keepHeader	boolean	لا	true	تكرار صف الرأس في كل ملف مخرَج

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/files/split-csv \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@large-dataset.csv" \
  -F 'settings={"rowsPerFile": 500, "keepHeader": true}'

مثال على الاستجابة

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/large-dataset_parts.zip",
  "originalSize": 1048576,
  "processedSize": 1050000
}

ملاحظات

• المخرجات دائمًا أرشيف ZIP يحتوي على أجزاء CSV المقسّمة، مُسمّاة تسلسليًا (مثل part-1.csv، part-2.csv).
• عندما تكون قيمة keepHeader هي true، يتضمّن كل جزء صف الرأس الأصلي بحيث يمكن استخدام كل ملف بمفرده.
• تُقبل ملفات CSV وTSV معًا كمدخلات.
• يشير عدد الصفوف إلى صفوف البيانات فقط؛ ولا يُحتسب صف الرأس.