Files
SnapOtter/apps/docs/id/tools/image/bulk-rename.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.6 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Ganti nama beberapa berkas menggunakan templat pola dan unduh sebagai ZIP. 2776dcc2f71c human 76f871222bea

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-{{index}}" Pola penamaan dengan placeholder (maks 1000 karakter)
startIndex number Tidak 1 Nomor indeks awal

Placeholder Pola

Placeholder Deskripsi Contoh
{{index}} Nomor berurutan mulai dari startIndex 1, 2, 3
{{padded}} Nomor berurutan berpad nol 01, 02, 03
{{original}} 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 "file=@photo1.jpg" \
  -F "file=@photo2.jpg" \
  -F "file=@photo3.jpg" \
  -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 {{padded}} 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.