Welche Platzhalter es gibt, weiß jetzt die API
Wer eine Vorlage baut, braucht zwei Auskünfte: welche Platzhalter es gibt und wie die Syntax dafür lautet. Beides lässt sich jetzt über die Schnittstelle abfragen — für E-Mails, Textbausteine, Landingpages und DOCX-Dokumente, jeweils genau die Felder, die dort auch aufgelöst werden. Damit prüft man Inhalte gegen die tatsächliche Feldliste, statt Platzhalter zu raten.
- Merge-Felder und Syntax für E-Mails, Textbausteine, Landingpages und DOCX über die API auslesbar
- Je Vorlagenart genau die Felder, die dort auch aufgelöst werden
- Inhalte außerhalb von propgen lassen sich gegen die tatsächliche Feldliste prüfen, statt Platzhalter zu raten
- Grundlage für das Anlegen von Vorlagen über die Schnittstelle
Wer eine Vorlage baut, braucht zwei Auskünfte: welche Platzhalter es überhaupt gibt und wie die Syntax dafür lautet. Bisher stand beides in der Oberfläche — wer außerhalb davon arbeitete, hat abgeschrieben oder geraten. Ab sofort fragt man die Schnittstelle.
Vier Orte, an denen Platzhalter gelten
Merge-Felder und die zugehörige Syntax lassen sich für alle vier Vorlagenarten über die API auslesen — jeweils genau die Felder, die dort auch tatsächlich aufgelöst werden:
Die Feldlisten unterscheiden sich, weil sich der Kontext unterscheidet: Was in einer E-Mail an einen Kontakt aufgelöst wird, ist nicht dasselbe wie das, was in einem Dokument zu einer Immobilie zur Verfügung steht. Genau deshalb ist Raten teuer — und die Abfrage nützlich.
Warum das mehr ist als eine Feldliste
- Kein Platzhalter, der ins Leere zeigt — wer Inhalte außerhalb von propgen erzeugt, prüft vorher gegen die tatsächliche Feldliste. Ein Platzhalter, den es nicht gibt, fällt beim Erzeugen auf statt beim Empfänger.
- Die Grundlage fürs Erzeugen — wer Vorlagen nicht nur lesen, sondern anlegen will, braucht zuerst diese Liste. Welche Vorlagenarten sich heute schreiben lassen, steht in Vorlagen per API anlegen.
Verfügbarkeit
Die Endpunkte stehen ab sofort zur Verfügung, mit denselben Rechten je API-Schlüssel wie der Rest der Schnittstelle. Einen Überblick über alles, was über die API läuft, gibt die Seite Public API.
Verwandte Releases: die Vorlagen in propgen als Grundlage, DOCX-Vorlagen für die Dokumentseite, Formulare per API für Masken und Felder und die Public API als Fundament.
Mehr zu allen propgen-Funktionen findest Du im Funktionsüberblick.