Search K
Toplu Yeniden Adlandırma
Dizin, dolgulu dizin ve özgün dosya adı için yer tutucular içeren bir kalıp şablonu kullanarak birden fazla dosyayı yeniden adlandırın. Yeniden adlandırılan tüm dosyaları içeren bir ZIP arşivi döndürür.
API Uç Noktası
POST /api/v1/tools/image/bulk-rename
Birden fazla dosya ve bir JSON settings alanı içeren multipart form verisi kabul eder.
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| pattern | dize | Hayır | "image-" | Yer tutuculu adlandırma kalıbı (en fazla 1000 karakter) |
| startIndex | sayı | Hayır | 1 | Başlangıç dizin numarası |
Kalıp Yer Tutucuları
| Yer Tutucu | Açıklama | Örnek |
|---|---|---|
| startIndex değerinden başlayan sıralı numara | 1, 2, 3 |
| Sıfır dolgulu sıralı numara | 01, 02, 03 |
| Uzantısız özgün dosya adı | photo, IMG_001 |
Özgün dosya uzantısı her zaman korunur.
Örnek İstek
bash
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}'Bu şunu üretir: vacation-1.jpg, vacation-2.jpg, vacation-3.jpg
Özgün dosya adını kullanma:
bash
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}}"}'Bu şunu üretir: 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg
Örnek Yanıt
Yanıt, doğrudan akıtılan bir ZIP dosyasıdır (JSON yanıtı değil). Yanıt üst bilgileri şunlardır:
Content-Type: application/zip
Content-Disposition: attachment; filename="renamed-a1b2c3d4.zip"Notlar
- Bu araç görselleri işlemez. Yalnızca dosyaları yeniden adlandırır ve bir ZIP arşivine paketler.
için sıfır dolgu genişliği, toplam dosya sayısına göre otomatik olarak belirlenir (ör. 100 dosya 3 haneli dolgu kullanır:001,002vb.).- Dosya uzantıları özgün dosya adlarından korunur.
- Dosya adları, güvensiz karakterleri kaldırmak için temizlenir.
- En az bir dosya sağlanmalıdır.