Lade eine kombinierte JSON-Datei hoch, die photobook und imageMap enthält.

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:

Webseite öffnen: Rufen Sie die Service-Webseite auf
JSON-Datei auswählen: Wählen Sie eine vorbereitete JSON-Datei mit photobook und imageMap
Seitengröße wählen: 21 cm (Standard) oder 29 cm
Vorschau-Modus: Optional aktivieren für schnellere Vorschau mit reduzierter Bildqualität
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

Schriftart

fontFamily im Layout legt die Schrift des ganzen Buches fest – Cover wie Innenseiten:

"josefin-sans" (Standard, auch wenn das Feld fehlt)
"josefin-slab"
"chewy" – nur ein Schnitt, Titel werden damit nicht fett

Unbekannte Werte und die im Editor stillgelegten Schriften ("lora", "italiana") fallen auf den Standard zurück – genau wie im Editor, damit Bildschirm und Druck übereinstimmen.

{ "layout": { "fontFamily": "josefin-slab", "cover": { ... }, "entries": [ ... ] } }

Textzone

Die Layouts text-top-image-bottom und text-top-2-images-bottom haben eine Textzone über den Bildern. Zwei optionale Felder steuern sie:

textHeight auf der Seite — wie hoch die Textzone ist:

"half" (Standard, auch wenn das Feld fehlt) — sie nimmt die halbe Seite ein
"auto" — sie passt sich ihrem Inhalt an. Nach oben ist sie auf 70 % der Nutzhöhe gedeckelt, damit langer Text die Bildzone nicht verdrängt. Der frei werdende Platz geht an die Bilder darunter.

showDate / showTitle / showContent im Textelement — welche Bestandteile gezeigt werden. Fehlt ein Feld, wird der Teil gezeigt; nur ein explizites false blendet ihn aus.

Sind alle drei auf false, zeigt die Textzone nichts mehr und fällt samt Zeilenabstand auf 0 zusammen — die Bilder beginnen dann am oberen Seitenrand und fluchten mit denen der Nachbarseite.

{
  "layout": "text-top-image-bottom",
  "textHeight": "auto",
  "elements": [
    {
      "position": 1,
      "type": "text",
      "text": { "alignment": "left", "showDate": true, "showTitle": true, "showContent": false }
    },
    { "position": 2, "type": "photo", "photo": { "entryImageId": "img-1" } }
  ]
}

Bei text-only wirken beide Felder nicht: dort füllt der Text ohnehin die ganze Seite.

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

Fotobuch Service – JSON Upload