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-"	Naamgevingspatroon met plaatshouders (max. 1000 tekens)
startIndex	number	Nee	1	Startindexnummer

Patroonplaatshouders

Plaatshouder	Beschrijving	Voorbeeld
	Volgnummer beginnend vanaf startIndex	1, 2, 3
	Volgnummer opgevuld met nullen	01, 02, 03
	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 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.