mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Đổi tên nhiều tệp bằng một mẫu khuôn dạng và tải xuống dưới dạng ZIP.	2776dcc2f71c	human	a4147e32af58

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-{{index}}"`	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
`{{index}}`	Số tuần tự bắt đầu từ `startIndex`	`1`, `2`, `3`
`{{padded}}`	Số tuần tự được đệm bằng số không	`01`, `02`, `03`
`{{original}}`	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 "file=@photo1.jpg" \
  -F "file=@photo2.jpg" \
  -F "file=@photo3.jpg" \
  -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 {{padded}} đượ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.

2.9 KiB Raw Blame History