Ganti Nama Massal

Ganti nama beberapa berkas menggunakan templat pola dengan placeholder untuk indeks, indeks berpad, dan nama berkas asli. Mengembalikan arsip ZIP yang berisi semua berkas yang telah diganti namanya.

API Endpoint

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

Menerima data formulir multipart dengan beberapa berkas dan bidang JSON settings.

Parameter

Parameter	Tipe	Wajib	Bawaan	Deskripsi
pattern	string	Tidak	"image-"	Pola penamaan dengan placeholder (maks 1000 karakter)
startIndex	number	Tidak	1	Nomor indeks awal

Placeholder Pola

Placeholder	Deskripsi	Contoh
	Nomor berurutan mulai dari startIndex	1, 2, 3
	Nomor berurutan berpad nol	01, 02, 03
	Nama berkas asli tanpa ekstensi	photo, IMG_001

Ekstensi berkas asli selalu dipertahankan.

Contoh Permintaan

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

Ini menghasilkan: vacation-1.jpg, vacation-2.jpg, vacation-3.jpg

Menggunakan nama berkas asli:

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

Ini menghasilkan: 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg

Contoh Respons

Respons berupa berkas ZIP yang dialirkan langsung (bukan respons JSON). Header respons adalah:

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

Catatan

• Alat ini tidak memproses gambar. Alat ini hanya mengganti nama berkas dan mengemasnya ke dalam arsip ZIP.
• Lebar pad-nol untuk ditentukan secara otomatis berdasarkan jumlah total berkas (mis. 100 berkas akan menggunakan pad 3 digit: 001, 002, dll.).
• Ekstensi berkas dipertahankan dari nama berkas asli.
• Nama berkas dibersihkan untuk menghapus karakter yang tidak aman.
• Setidaknya satu berkas harus disediakan.