mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
2.7 KiB
2.7 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Hernoem meerdere bestanden met een patroonsjabloon en download ze als ZIP. | 2776dcc2f71c | human | 81e94f6cfbd1 |
Bulk hernoemen
Hernoem meerdere bestanden met een patroonsjabloon met plaatshouders voor index, opgevulde index en originele bestandsnaam. Retourneert een ZIP-archief met alle hernoemde bestanden.
API-endpoint
POST /api/v1/tools/image/bulk-rename
Accepteert multipart form data met meerdere bestanden en een JSON-veld settings.
Parameters
| Parameter | Type | Vereist | Standaard | Beschrijving |
|---|---|---|---|---|
| pattern | string | Nee | "image-{{index}}" |
Naamgevingspatroon met plaatshouders (max. 1000 tekens) |
| startIndex | number | Nee | 1 |
Startindexnummer |
Patroonplaatshouders
| Plaatshouder | Beschrijving | Voorbeeld |
|---|---|---|
{{index}} |
Volgnummer beginnend vanaf startIndex |
1, 2, 3 |
{{padded}} |
Volgnummer opgevuld met nullen | 01, 02, 03 |
{{original}} |
Originele bestandsnaam zonder extensie | photo, IMG_001 |
De originele bestandsextensie blijft altijd behouden.
Voorbeeldaanvraag
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}'
Dit produceert: vacation-1.jpg, vacation-2.jpg, vacation-3.jpg
Met gebruik van de originele bestandsnaam:
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}}"}'
Dit produceert: 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg
Voorbeeldantwoord
Het antwoord is een ZIP-bestand dat direct wordt gestreamd (geen JSON-antwoord). De antwoordheaders zijn:
Content-Type: application/zip
Content-Disposition: attachment; filename="renamed-a1b2c3d4.zip"
Opmerkingen
- Deze tool verwerkt geen afbeeldingen. Hij hernoemt alleen bestanden en verpakt ze in een ZIP-archief.
- De opvulbreedte met nullen voor
{{padded}}wordt automatisch bepaald op basis van het totale aantal bestanden (100 bestanden zouden bijvoorbeeld 3-cijferige opvulling gebruiken:001,002, enz.). - Bestandsextensies blijven behouden van de originele bestandsnamen.
- Bestandsnamen worden opgeschoond om onveilige tekens te verwijderen.
- Er moet ten minste één bestand worden opgegeven.