---

Fotobuch Service - Benutzeranleitung

Was ist das?

Dies ist ein Service für die Erstellung von digitalen Fotobüchern. Sie senden eine JSON-Datei mit Fotobuch-Layout und Bild-URLs und erhalten automatisch ein PDF-Fotobuch zurück.

API-Endpunkt

POST /upload

Erwartet einen JSON-Body mit folgenden Feldern:

{
  "photobook": { ... },
  "imageMap": { "entryImageId": "https://..." },
  "entryMap": { "entryId": { "title": "...", "content": "...", "entryDate": "..." } },
  "config": {
    "pageSize": "21cm",
    "preview": false
  }
}

Felder:

• photobook (erforderlich): Das Fotobuch-Layout mit Cover und Einträgen
• imageMap (erforderlich): Zuordnung von Bild-IDs zu Bild-URLs (z.B. S3-URLs)
• entryMap: Zuordnung von Eintrags-IDs zu Metadaten (Titel, Text, Datum)
• config.pageSize: Seitengröße ("21cm" Standard oder "29cm")
• config.preview: Vorschau-Modus mit reduzierter Bildqualität (true/false)

Weboberfläche

Alternativ können Sie die JSON-Datei auch über die Weboberfläche hochladen:

1. Webseite öffnen: Rufen Sie die Service-Webseite auf
2. JSON-Datei auswählen: Wählen Sie eine vorbereitete JSON-Datei mit photobook und imageMap
3. Seitengröße wählen: 21 cm (Standard) oder 29 cm
4. Vorschau-Modus: Optional aktivieren für schnellere Vorschau mit reduzierter Bildqualität
5. PDF erstellen: Das fertige PDF-Fotobuch öffnet sich automatisch in einem neuen Browser-Tab

Fotobuch-Struktur

Cover

Das Cover enthält ein Layout (square, round oder arch), optional ein Bild, Farben und Texte.

Einträge

Jeder Eintrag besteht aus einer oder mehreren Seiten. Jede Seite hat ein Layout und Elemente (Fotos oder Texte).

Verfügbare Seitenlayouts:

• text-only — Nur Text
• full-image — Ein Vollbild
• text-top-image-bottom — Text oben, Bild unten
• text-top-2-images-bottom — Text oben, 2 Bilder unten
• 2-images-vertical — 2 Bilder vertikal
• 2-images-horizontal — 2 Bilder horizontal
• image-top-2-images-bottom — Bild oben, 2 Bilder unten
• 2-images-top-image-bottom — 2 Bilder oben, Bild unten
• 2-image-top-2-images-bottom — 2 Bilder oben, 2 Bilder unten
• 3-image-top-2-images-bottom — 3 Bilder oben, 2 Bilder unten
• 2-image-top-3-images-bottom — 2 Bilder oben, 3 Bilder unten

Hinweise

• Seitenformat: quadratisch (21×21 cm oder 29×29 cm)
• Maximale Upload-Größe: 500 MB
• Bilder werden über die URLs im imageMap geladen
• Im Vorschau-Modus werden Bilder auf max. 800px skaliert und als JPEG 70% komprimiert

---