Bulk Rename

Đổi tên nhiều tệp bằng một mẫu khuôn dạng với các trình giữ chỗ cho chỉ số, chỉ số được đệm và tên tệp gốc. Trả về một kho lưu trữ ZIP chứa tất cả tệp đã đổi tên.

API Endpoint

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

Chấp nhận dữ liệu biểu mẫu multipart với nhiều tệp và một trường JSON settings.

Parameters

Parameter	Type	Required	Default	Description
pattern	string	No	"image-"	Mẫu đặt tên với các trình giữ chỗ (tối đa 1000 ký tự)
startIndex	number	No	1	Số chỉ số bắt đầu

Pattern Placeholders

Placeholder	Description	Example
	Số tuần tự bắt đầu từ startIndex	1, 2, 3
	Số tuần tự được đệm bằng số không	01, 02, 03
	Tên tệp gốc không có phần mở rộng	photo, IMG_001

Phần mở rộng tệp gốc luôn được giữ nguyên.

Example Request

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

Điều này tạo ra: vacation-1.jpg, vacation-2.jpg, vacation-3.jpg

Sử dụng tên tệp gốc:

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

Điều này tạo ra: 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg

Example Response

Phản hồi là một tệp ZIP được truyền trực tiếp (không phải phản hồi JSON). Các tiêu đề phản hồi là:

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

Notes

• Công cụ này không xử lý hình ảnh. Nó chỉ đổi tên tệp và đóng gói chúng vào một kho lưu trữ ZIP.
• Độ rộng đệm số không cho được xác định tự động dựa trên tổng số tệp (ví dụ 100 tệp sẽ dùng đệm 3 chữ số: 001, 002, v.v.).
• Phần mở rộng tệp được giữ nguyên từ tên tệp gốc.
• Tên tệp được làm sạch để loại bỏ các ký tự không an toàn.
• Phải cung cấp ít nhất một tệp.