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

3.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Renomme plusieurs fichiers à l'aide d'un modèle de motif et les télécharge sous forme de ZIP.	2776dcc2f71c	human	ec51a289e6cb

Renommage en masse

Renomme plusieurs fichiers à l'aide d'un modèle de motif comportant des espaces réservés pour l'index, l'index complété par des zéros et le nom de fichier d'origine. Renvoie une archive ZIP contenant tous les fichiers renommés.

Point de terminaison de l'API

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

Accepte des données de formulaire multipart contenant plusieurs fichiers et un champ JSON settings.

Paramètres

Paramètre	Type	Requis	Par défaut	Description
pattern	chaîne	Non	`"image-{{index}}"`	Motif de nommage avec espaces réservés (max 1000 caractères)
startIndex	nombre	Non	`1`	Numéro d'index de départ

Espaces réservés du motif

Espace réservé	Description	Exemple
`{{index}}`	Numéro séquentiel à partir de `startIndex`	`1`, `2`, `3`
`{{padded}}`	Numéro séquentiel complété par des zéros	`01`, `02`, `03`
`{{original}}`	Nom de fichier d'origine sans extension	`photo`, `IMG_001`

L'extension du fichier d'origine est toujours préservée.

Exemple de requête

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

Cela produit : vacation-1.jpg, vacation-2.jpg, vacation-3.jpg

En utilisant le nom de fichier d'origine :

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

Cela produit : 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg

Exemple de réponse

La réponse est un fichier ZIP diffusé directement (et non une réponse JSON). Les en-têtes de la réponse sont :

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

Remarques

Cet outil ne traite pas les images. Il se contente de renommer les fichiers et de les regrouper dans une archive ZIP.
La largeur du complément par des zéros pour {{padded}} est déterminée automatiquement en fonction du nombre total de fichiers (par exemple, 100 fichiers utiliseraient un complément à 3 chiffres : 001, 002, etc.).
Les extensions de fichier sont conservées à partir des noms de fichiers d'origine.
Les noms de fichiers sont assainis pour supprimer les caractères non sûrs.
Au moins un fichier doit être fourni.

3.0 KiB Raw Blame History