German

English

German

English

Theme

Landingpage-Template-API ​

Achte auf die Details!

Diese Seite behandelt lediglich Landingpage-Templates.

Eine funktionale Landingpage besteht aus 2 Grundelementen. Einem solchen Template, das die Daten über Struktur und Stil der Seite enthält, sowie einem Event oder einer Abonnement-Gruppe, welche die zugrundeliegenden Termine definiert.

Alle/Neueste Landingpage-Templates listen ​

GET /landingpage/all

Gibt eine Liste mit den IDs aller verfĂĽgbaren Landingpage-Templates zurĂĽck.

GET /landingpage/latest

Gibt das neueste Landingpage-Template zurĂĽck.

Ein Landingpage-Template lesen ​

GET /landingpage/:id

Beim Abrufen eines bestimmten Landingpage-Templates sind keine zusätzlichen Parameter möglich. Es wird lediglich die ID in der Anfrage-URL benötigt, um alle Daten für ein bestimmtes Element zu erhalten.

Mögliche Response ​

json
{
  "id": 67,
  "name": "RSVP LP",
  "header_image": null,
  "title": "",
  "intro": "<p>Reserviere noch heute deinen Platz!</p>",
  "legal": null,
  "highlight_color": "#9456ff",
  "background": "preset",
  "gradient_direction": null,
  "background_color_1": "#000000",
  "background_color_2": null,
  "image": "9aee3e8a-481b-4b26-89a2-e2bf9f72d2da",
  "image_repeat": true,
  "meta_title_override": null,
  "meta_robots_override": true,
  "meta_description_override": null,
  "custom_domain": null,
  "date_created": "2024-06-27T07:21:15.739Z",
  "date_updated": "2025-04-12T18:57:40.863Z"
}

Landingpage-Template erstellen ​

POST /landingpage

FĂĽr die Erstellung eines neuen Landingpage-Templates muss mindestens das Feld "name" im Body angegeben werden.

json
{
  "name": "Name des Elements" // nur intern
}

Möglicher Request mit allen Feldern ​

json
{
  "name": "Name des Elements",
  "title": "Willkommen auf meiner Webseite",
  "intro": "<p>Ein Text...</p>", // Einleitungstext; erlaubt HTML
  "legal": "<p>&copy; 2025, ACME Inc.</p>", // Rechtlicher FuĂźzeilentext; erlaubt HTML
  "highlight_color": "#fcba03", // Hex-Code; wird fĂĽr Buttons und dekorative Elemente verwendet
  "background": "preset", // Optionen: solid, gradient, image, preset (wie image, aber mit einer Datei aus unserer Bibliothek)
  "gradient_direction": null, // Optionen: linear-t, linear-tr, linear-r, linear-br, radial; nur bei background = "gradient"
  "background_color_1": "#000000", // Hex-Code
  "background_color_2": null, // Hex-Code; nur bei background = "gradient"
  "image_repeat": true, // ob das Hintergrundbild im Vollbild angezeigt oder wiederholt werden soll
  "meta_title_override": null, // Text, der den automatisch generierten Meta-Titel ĂĽberschreibt
  "meta_robots_override": true, // wenn true, setzen wir "norobots, noindex"
  "meta_description_override": null, // Text, der die automatisch generierte Meta-Beschreibung ĂĽberschreibt
  "custom_domain": null // ID einer eingerichteten Custom Domain
}

Kein Bild bei POST/PATCH

Beachte, dass du kein Bild fĂĽr den Header oder bei Verwendung der image-Option als Hintergrund angeben kannst! Dies kann nur ĂĽber unsere Web-App erfolgen.

Mögliche Response ​

json
{
  "status": "success",
  "message": "created",
  "id": "67"
}

Die ID aus einer erfolgreichen RĂĽckmeldung kannst du fĂĽr weitere Schritte verwenden - bspw. im Zuge der Erstellung eines neuen Events.


Landingpage-Template aktualisieren ​

PATCH /landingpage/:id

Die Aktualisierung eines Landingpage-Templates folgt denselben Regeln wie die Erstellung eines neuen.


Landingpage-Template löschen ​

DELETE /landingpage/:id

Das Löschen eines Landingpage-Templates ist einfach. Gib hierzu lediglich die ID an, und es wird entfernt.

Sei bei diesem Aufruf sehr vorsichtig!

Dies löscht keine Events oder Gruppen!

Sie bleiben aktiv, verwenden dann aber stattdessen das generische Standard-Landingpage-Template.