de en


Webservice (API): Changelog

20.10.2025 Bugfix in Funktionen 'ExportHistory' und 'GetHistory'

Beide Funktionen liefern eine chronologisch sortierte Liste von Abonnenten-Events für eine Vielzahl von Event-Typen. Für den Event-Typ 'optout' wurde ein Fehler behoben, wenn im Parameter 'listFilter' mehrere Listen-IDs mitgegeben wurden. Diese IDs wirken nun als ODER-Verknüpfung, wie auch bei allen anderen Event-Typen. Das heißt, jede Abmeldung in einer der angefragten Listen wird zurückgeliefert.

19.08.2025 Neue Funktionen 'ExportHistory' und 'GetExportHistoryJobById'

Die Funktion 'Export History' startet einen Job, der eine chronologisch sortierte Liste von Abonnenten-Events als CSV-Datei exportiert.

Enthalten sind Events aller An- und Abmeldungen, Profiländerungen, Versendungen, Zustellungen, Bounces, Öffnungen, Klicks, Tell-a-friend sowie Nicht-Versendungen aufgrund Blacklist, Beschwerdeliste, Ausschlussliste, Retained List oder logisch falscher E-Mail-Adresse. 'Export History' ist der verbesserte Nachfolger von 'GetHistory'. Vorteil: Die neue Funktion verarbeitet mit einem einzigen Aufruf eine beliebig große Datenmenge. 'Export History' liefert eine jobId und startet im Hintergrund einen Job. Anschließend fragen Sie über 'GetExportHistoryJobById' den Jobstatus ab, bis der Staus auf 'done' wechselt. Das Resultat enthält im Parameter 'url' den Download-Link zur erzeugten CSV-Datei.

  • Bitte nutzen Sie bei jedem Call möglichst präzise Filter-Parameter. So erhalten Sie mit maximaler Verarbeitungsgeschwindigkeit die minimale Datenmenge, die Ihnen die Verarbeitung im nächsten Schritt erleichtert.
  • Alle unterstützten Filter-Parameter sind kombinierbar: Zeitraum, Event-Typen, Abonnentenlisten, Abonnentenfeld-Werte, Abonnenten-IDs.
  • Für den Aufbau der CSV-Datei werden die Nutzereinstellungen des Menüs "Eigene Einstellungen -> Voreinstellung für Export" benutzt: Zeichenkodierung, Spaltentrenner, Feldtrenner.
  • Der Download-Link ist 48 Stunden gültig. Die URL kann nicht mit accountfremden Logindaten ermittelt werden. Die URL ist jedoch öffentlich erreichbar, sollte sie bekannt sein.
  • Die Anzahl gleichzeitig laufender ExportHistory-Jobs ist limitiert auf 1 Job pro Account und 2 Jobs systemweit.
Tags: