Postkarten-API: Sandbox, PDF-Vorschau und eigene Motive

Im Mai haben wir den MCP-Server und die neue Version der Postkarten-API vorgestellt. Seitdem kommen deutlich mehr Karten über die API zu uns. Gleichzeitig sprechen wir mit Anbietern, die die Postkarte fest in ihr Kundenerlebnis einbauen wollen. Da geht es zum Beispiel um Messe-Aktionen, bei denen jedes Gespräch am Stand eine persönliche Karte an den Kontakt auslöst. Oder um ein Angebot für Privatkunden, bei dem die Postkarte per QR-Code ein individuelles Musikstück zum Empfänger bringt.

Damit solche Ideen schneller vom ersten Test in den Alltag kommen, haben wir die API erweitert. Das ist neu.

Testen in der Sandbox

Beim Anlegen eines API-Schlüssels wählst du jetzt zwischen Live und Sandbox. Ein Sandbox-Schlüssel beginnt mit ep_test_. Karten, die du damit anlegst, rendern wir vollständig, drucken und berechnen sie aber nicht. Kontakte, Gruppen und Karten aus der Sandbox bleiben von deinen echten Daten getrennt.

In deiner Kartenübersicht stehen die Testkarten mit einer Sandbox-Markierung. Dort siehst du die Druckvorschau für jeden Empfänger, mit deinem Logo und dem Text auf der Mittellinie, falls du beides gebucht hast. Wenn du fertig bist, löschst du die Sandbox-Daten mit einem Klick in den Einstellungen. Auch der MCP-Server versteht Sandbox-Schlüssel.

Jede Karte vorab als PDF

Mit GET /v2/cards/{id}/preview.pdf holst du dir eine angelegte Karte als PDF. Seite eins zeigt die Rückseite mit Text, Adresse und Poststempel, Seite zwei die Vorderseite mit dem Motiv. Das klappt für Sandbox- und Live-Karten. So baust du in deinem eigenen System einen Freigabeschritt ein, bevor die Karte in den Druck geht.

Eigene Motive per Upload

Über die API lädst du eigene Bilder als Motiv hoch, zum Beispiel ein Foto vom Messestand oder eine Grafik mit dem Namen des Empfängers. Diese Motive sind für einzelne Versände gedacht, nicht für dein dauerhaftes Sortiment. Rund zehn Tage nach dem Versand löschen wir die Bilddateien wieder.

Den Upload schalten wir nach einer kurzen Abstimmung frei. Wir fragen dabei nach deinem Anwendungsfall und prüfen, ob Zahlungsdaten und Guthaben im Konto hinterlegt sind. Schreib uns dafür über das Kontaktformular auf unserer Hilfeseite.

Text auf der Mittellinie pro Karte

Wenn du den eigenen Text für die Mittellinie der Rückseite gebucht hast, setzt du ihn über die API jetzt für jede Karte einzeln. Das gilt auch für Karten aus einer Vorlage. Bei einem Mailing für mehrere Filialen kann so jede Karte die Filiale nennen, die den Empfänger betreut. Dein Logo auf der Rückseite gilt weiterhin für das ganze Konto. Du änderst es jederzeit in den Einstellungen.

Kleinere Verbesserungen

• Das Versanddatum ist optional. Ohne Datum planen wir die Karte für den nächsten Werktag ein. Fällt dein Datum auf ein Wochenende oder einen Feiertag der Druckerei, verschieben wir die Karte auf den nächsten Drucktag.
• Schickst du Text für ein Feld, das dein Motiv nicht druckt, etwa ein P.S. bei einem Motiv ohne P.S.-Zeile, antwortet die API sofort mit einem Fehler. Der Text fällt also nicht still unter den Tisch.
• Jede Karte enthält in der API-Antwort einen Link auf dieselbe Karte in der Web-App (web_url).
• Kontakte lassen sich nach Name und Adresse filtern.
• Alle Anreden aus der App kannst du auch über die API nutzen.
• Pro Karte hinterlegst du mehrere E-Mail-Benachrichtigungen, etwa eine Erinnerung vor dem Versand und eine Bestätigung danach.

So startest du

Alle Details stehen in der API-Doku (Englisch). Einen Überblick mit Beispielen findest du auf den Seiten zur Postkarten-API und zum Postkarten-MCP. Wenn du eine Idee hast, wie die Postkarte in deinen Ablauf passt, schreib uns über das Kontaktformular. Wir schauen sie uns gern mit dir an.