إعادة التسمية الجماعية

أعِد تسمية عدّة ملفات باستخدام قالب نمط يحوي عناصر نائبة للفهرس والفهرس المبطّن واسم الملف الأصلي. تُرجع أرشيف ZIP يحتوي على جميع الملفات المُعاد تسميتها.

نقطة نهاية API

POST /api/v1/tools/image/bulk-rename

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

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
pattern	string	لا	"image-"	نمط التسمية مع العناصر النائبة (بحدّ أقصى 1000 حرف)
startIndex	number	لا	1	رقم الفهرس الابتدائي

العناصر النائبة في النمط

العنصر النائب	الوصف	مثال
	رقم تسلسلي يبدأ من startIndex	1، 2، 3
	رقم تسلسلي مبطّن بالأصفار	01، 02، 03
	اسم الملف الأصلي بدون امتداد	photo، IMG_001

يُحفَظ امتداد الملف الأصلي دائمًا.

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

curl -X POST http://localhost:1349/api/v1/tools/image/bulk-rename \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"pattern": "vacation-{{padded}}", "startIndex": 1}'

ينتج عن هذا: vacation-1.jpg، vacation-2.jpg، vacation-3.jpg

باستخدام اسم الملف الأصلي:

curl -X POST http://localhost:1349/api/v1/tools/image/bulk-rename \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@IMG_001.jpg" \
  -F "file=@IMG_002.jpg" \
  -F 'settings={"pattern": "2024-trip-{{original}}-{{index}}"}'

ينتج عن هذا: 2024-trip-IMG_001-1.jpg، 2024-trip-IMG_002-2.jpg

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

الاستجابة ملف ZIP مُدفَّق مباشرةً (وليست استجابة JSON). ترويسات الاستجابة هي:

Content-Type: application/zip
Content-Disposition: attachment; filename="renamed-a1b2c3d4.zip"

ملاحظات

• لا تعالج هذه الأداة الصور. فهي تُعيد تسمية الملفات فقط وتحزمها في أرشيف ZIP.
• يُحدَّد عرض التبطين بالأصفار لـ تلقائيًا بناءً على العدد الإجمالي للملفات (مثلًا 100 ملف تستخدم تبطينًا من 3 خانات: 001، 002، إلخ).
• تُحفَظ امتدادات الملفات من أسماء الملفات الأصلية.
• تُنقَّى أسماء الملفات لإزالة الأحرف غير الآمنة.
• يجب توفير ملف واحد على الأقل.