🚀 Szybkie Linki
📡 Dostępne Endpointy
- GET /health — Status serwera
- GET /ui/image-to-xmp — Generuj z obrazka
- GET /ui/generate — Interfejs graficzny
- GET /api/example-inputs — Dane przykładowe (JSON)
- POST /api/analyze-image — Analizuj obrazek (OpenAI Vision)
- POST /api/generate-from-image — Generuj XMP z obrazka
- POST /api/generate — Generuj paczki
- POST /api/example — Szybka generacja z przykładami
📝 Jak Zacząć
Opcja 1: Graficzny UI
Kliknij "UI Generatora" powyżej, załaduj przykłady jednym przyciskiem i wyślij POST.
Kliknij "UI Generatora" powyżej, załaduj przykłady jednym przyciskiem i wyślij POST.
Opcja 2: cURL / API
Szybki przykład:
Szybki przykład:
curl -X POST http://localhost:3000/api/exampleRezultat trafi do
output/ z manifest.json, checksums.txt i .zip.
Opcja 3: WĹ‚asny JSON
POST na
UI formularz pokazuje strukturÄ™.
POST na
/api/generate z templateXmpText, packRequest, allowlist (i opcjonalnie seed).
UI formularz pokazuje strukturÄ™.
✨ Kluczowe Cechy
Struktura XMP
Immutable — bez zmian struktury, tylko wartości.
Immutable — bez zmian struktury, tylko wartości.
Allowlist PĂłl
Ścisła walidacja — tylko dozwolone pola.
Ścisła walidacja — tylko dozwolone pola.
Determinizm
Seed dla powtarzalnych wynikĂłw.
Seed dla powtarzalnych wynikĂłw.
Klony SEO
Tasowanie, warianty, metadane.
Tasowanie, warianty, metadane.
Walidacja
Struktura, pola, zakresy wartości.
Struktura, pola, zakresy wartości.
Output
ZIP z manifest.json i checksumami.
ZIP z manifest.json i checksumami.
đź› Technologia
Backend: Node.js + Express
XML: xml2js (parse/build)
Archiving: archiver (ZIP)
RNG: seedrandom (determinizm)
Hashing: crypto (SHA-256)
Frontend: Vanilla JS (bez build toolĂłw)