Referenzindex der API-Methoden

Pushwoosh bietet eine umfangreiche Bibliothek mit über 100 API-Methoden, die für verschiedene Funktionalitäten wie das Senden von Benachrichtigungen, die Verwaltung von Benutzern und das Tracking von Analysen kategorisiert sind.

Messaging API v2

Eine einheitliche API, die die gesamte /create*Message-Familie (Push, E-Mail, SMS, Kakao) ersetzt. Siehe die Übersicht und den Migrationsleitfaden.

Notify	Erstellt und sendet eine einzelne Nachricht über einen beliebigen Kanal. Ersetzt /createMessage, /createTargetedMessage, /createEmailMessage, /createSMSMessage, /createKakaoMessage.
Cancel	Storniert eine zuvor erstellte Nachricht, bevor sie zugestellt wird. Verwenden Sie den message_code von Notify.
Update	Ersetzt eine noch geplante Nachricht durch eine neue Definition (vollständiger Ersatz). Verwenden Sie den message_code von Notify.

SMTP-Gateway

Senden Sie transaktionale E-Mails über Standard-SMTP, anstatt die API direkt aufzurufen. Das Gateway authentifiziert sich mit Ihrem Anwendungscode und API-Token und leitet dann jede Nachricht an Notify weiter. Siehe die SMTP-Gateway-Referenz.

Messages API

createMessage Veraltet	Erstellt eine neue Push-Benachrichtigung. Verwenden Sie stattdessen Notify.
deleteMessage	Löscht eine Nachricht (gesendet oder geplant) und entfernt sie aus dem Nachrichtenverlauf.
getMessageDetails	Ruft die Nachrichtendetails ab.
createTargetedMessage Veraltet	Erstellt eine neue gezielte Push-Benachrichtigung. Verwenden Sie stattdessen Notify mit der Art transactional.
getPushHistory Veraltet	Verwenden Sie /messages:list, um den Nachrichtenverlauf mit detaillierten Daten abzurufen.
cancelMessage	Storniert eine geplante Nachricht und behält sie im Nachrichtenverlauf.

Presets API

Create	Erstellt eine neue Push-Voreinstellung.
List	Listet die Push-Voreinstellungen einer Anwendung auf.
Get	Ruft eine einzelne Push-Voreinstellung nach Code ab.
Update	Überschreibt eine Push-Voreinstellung nach Code.
UpdatePartial	Aktualisiert nur die angegebenen Felder einer Push-Voreinstellung nach Code.
Clone	Dupliziert eine Push-Voreinstellung innerhalb derselben Anwendung.
Delete	Löscht eine Push-Voreinstellung nach Code.

Device API

registerDevice	Registriert ein Gerät für die Anwendung.
unregisterDevice	Entfernt das Push-Token des Geräts.
deleteDevice	Löscht ein Gerät und alle zugehörigen Daten in der angegebenen Anwendung.
setTags	Setzt Tag-Werte für das Gerät.
getTags	Ruft Tags mit ihren entsprechenden Werten für ein bestimmtes Gerät ab.
setBadge	Sendet den aktuellen Badge-Wert für ein Gerät an Pushwoosh.
applicationOpen	Registriert ein App-Öffnungsereignis.
pushStat	Registriert ein Push-Öffnungsereignis.
messageDeliveryEvent	Registriert ein Push-Zustellungsereignis für das Gerät.

Audience API

bulkSetTags	Setzt Tag-Werte für mehrere Geräte.
bulkSetTags Status	Gibt den Status der bulkSetTags-Operation zurück.
bulkRegisterDevice	Registriert mehrere Geräte in einer einzigen Anfrage, einschließlich optionaler Tag-Werte für jedes Gerät.
bulkRegisterDevice Status	Ruft den Status und die Ergebnisse einer Massenregistrierungsanfrage für Geräte unter Verwendung einer Anfrage-ID ab.
bulkUnregisterDevice	Meldet mehrere Geräte in einer einzigen Anfrage ab.
bulkUnregisterDevice Status	Ruft den Status und die Ergebnisse einer Massenabmeldungsanfrage für Geräte unter Verwendung einer Anfrage-ID ab.

Tags API

addTag	Erstellt ein Tag in Ihrem Konto.
deleteTag	Entfernt ein Tag mit allen zugehörigen Informationen.
listTags	Ruft eine Liste der Tags im Konto ab.

Segmentation (Filters) API

createFilter	Erstellt ein neues Segment.
listFilters	Gibt eine Liste der verfügbaren Segmente mit ihren Bedingungen zurück.
deleteFilter	Löscht ein bestehendes Segment.
exportSegment	Plant eine Anfrage zum Exportieren von Abonnenten, die den Segmentbedingungen entsprechen.
exportSegment Results	Ruft den CSV-Link für die Ergebnisse von exportSegment ab.

User-centric API

registerUser	Verknüpft eine externe Benutzer-ID mit einem bestimmten Gerät.
deleteUser	Löscht einen Benutzer und alle Geräte, die mit der angegebenen Benutzer-ID verknüpft sind.
postEvent	Ruft das Ereignis innerhalb der App auf.

Events API

createEvent	Erstellt ein Ereignis für die App.

Applications API

createApplication	Erstellt eine neue Anwendung im Konto.
updateApplication	Aktualisiert die Anwendungseinstellungen.
deleteApplication	Löscht die App aus dem Konto.
getApplication	Ruft Details zur App ab.
getApplications	Ruft eine Liste der Anwendungen im Konto ab.
getApplicationFile	Ruft die Konfigurationsdateien ab, die sich auf die App beziehen.
setApplicationPlatformStatus	Ändert den Plattformstatus der App.

Campaigns API

createCampaign	Erstellt eine neue Push-Kampagne.
deleteCampaign	Löscht eine bestimmte Kampagne.
getCampaigns	Ruft eine Liste der Kampagnen für die App ab.

App configuration API

configureApplication for iOS	Konfiguriert die iOS-Plattform für die App.
configureApplication for Android	Konfiguriert die Android-Plattform für die App.
configureApplication for Mac OS X	Konfiguriert die macOS-Plattform für die App.
configureApplication for Windows	Konfiguriert die Windows-Plattform für die App.
configureApplication for Amazon	Konfiguriert die Amazon-Plattform für die App.
configureApplication for Chrome	Konfiguriert die Chrome-Plattform für die App.
configureApplication for Safari	Konfiguriert die Safari-Plattform für die App.
configureApplication for Firefox	Konfiguriert die Firefox-Plattform für die App.
configureApplication for Email	Konfiguriert die E-Mail-Plattform für die App.

Email API

createEmailMessage Veraltet	Erstellt eine E-Mail-Nachricht. Verwenden Sie stattdessen Notify mit platforms: ["EMAIL"] und einem email_payload.
registerEmail	Registriert eine E-Mail-Adresse für die App.
deleteEmail	Entfernt eine E-Mail-Adresse aus Ihrer Datenbank.
setEmailTags	Setzt Tag-Werte für die angegebene E-Mail-Adresse.
registerEmailUser	Verknüpft eine externe Benutzer-ID mit einer angegebenen E-Mail-Adresse.

Email Templates API

Create	Erstellt eine neue E-Mail-Vorlage in einer Anwendung.
List	Listet die E-Mail-Vorlagen einer Anwendung auf.
Get	Gibt eine einzelne E-Mail-Vorlage nach Code zurück.
Update	Aktualisiert eine bestehende E-Mail-Vorlage nach Code.
Delete	Löscht eine E-Mail-Vorlage und ihre verbundene Voreinstellung nach Code.
Clone	Klont eine E-Mail-Vorlage in eine Zielanwendung.

Test devices API

createTestDevice	Registriert ein Testgerät für die Anwendung.
listTestDevices	Ruft alle für die Anwendung registrierten Testgeräte ab.

Message inbox API

getInboxMessages	Ruft die Liste der Posteingangsnachrichten für eine bestimmte HWID ab.
inboxStatus	Aktualisiert den Status einer bestimmten Posteingangsnachricht.

Statistics API

Message statistics

messages:list	Ruft eine Liste der gesendeten Nachrichten ab.
totalsByIntervals	Stellt Metriken und Konversionsdaten bereit, die stündlich aggregiert werden.
getDeliveryFunnel	Gibt den Zustellungstrichter für eine einzelne Nachricht zurück, mit einer Aufschlüsselung, wo die Zielgruppe in jeder Phase verloren geht.
getMessageLog	Ruft detaillierte Informationen zu gesendeten Nachrichten ab.
linksInteractions	Stellt Statistiken zu Klicks auf E-Mail-Links bereit.
linksInteractionsDevices	Listet Benutzer auf, die auf Links in E-Mails geklickt haben.
bouncedEmails	Stellt Informationen zu E-Mail-Bounces, Beschwerden und Bounce-Gründen bereit.

Asynchronous message statistics export

exportMessagesStatistics/export	Stellt einen Nachrichtenverlaufsexport in eine CSV-Datei in die Warteschlange, ohne die Zeilenbeschränkungen von messages:list.
exportMessagesStatistics/status	Gibt den Fortschritt einer Exportaufgabe zurück.
exportMessagesStatistics/result	Gibt den generierten Dateinamen zurück, sobald die Aufgabe abgeschlossen ist.
exportMessagesStatistics/lastTasks	Listet die letzten Exportaufgaben für eine Anwendung auf.
exportMessagesStatistics/delete	Löscht eine Aufgabe und ihre Datei vor Ablauf des Aufbewahrungszeitraums.
exportMessagesStatistics/download	Lädt die generierte CSV-Datei nach Namen herunter.

Application and subscriber statistics

getApplicationSubscribersStats	Ruft die Abonnentenstatistiken der App ab, gruppiert nach Gerätetyp.
getAppStats	Ruft App-Statistiken für einen bestimmten Zeitraum ab.
getSubscribersStatistics	Ruft Abonnentenstatistiken für einen bestimmten Zeitraum ab.

Campaign statistics

getCampaignStats	Ruft Kampagnenstatistiken für einen bestimmten Zeitraum ab.

Events and tags statistics

getEventStatistics	Ruft die Anzahl ab, wie oft ein Ereignis während eines bestimmten Zeitraums ausgelöst wurde.
getTagStats	Ruft Statistiken für ein bestimmtes Tag ab.

In-app statistics

inapps:totals	Ruft die Gesamtwerte für Impressionen, Interaktionen und Frequency Capping für eine oder mehrere In-App-Kampagnen über einen Zeitraum ab.
inapps:timeline	Ruft die Gesamtwerte des Zeitraums und eine Zeitreihe von In-App-Metriken für eine einzelne Kampagne ab.

iOS Live Activities API

startLiveActivity	Erstellt eine neue iOS Live Activity.
updateLiveActivity	Aktualisiert eine bestehende iOS Live Activity.

Apple Wallet PassKit API

Apple Wallet PassKit API	Referenz zur Verwaltung von Apple Wallet-Pässen und zugehöriger Konfiguration in Pushwoosh.

Google Wallet API

Create a pass	Erstellt den Pass in Google Wallet und gibt einen Speicherlink zurück.
Validate a pass	Überprüft eine Pass-Konfiguration, ohne sie zu erstellen.
Update a pass	Aktualisiert einen bestehenden Pass. Google übermittelt die Änderung an gespeicherte Geräte.
Get a save link	Gibt einen „Zu Google Wallet hinzufügen“-Speicherlink für einen bestehenden Pass zurück.
Get a pass	Gibt einen einzelnen gespeicherten Pass zurück.
List passes	Gibt eine paginierte Liste von Pässen für eine Anwendung zurück.
Set pass state	Aktiviert oder entwertet einen Pass.
Delete a pass	Entwertet den Pass in Google und entfernt seinen Pushwoosh-Eintrag.
Get configuration	Gibt den Konfigurationsstatus von Google Wallet für eine Anwendung zurück.
Templates	Listet Pass-Vorlagen auf oder ruft eine als Ausgangspunkt ab.

Customer Journey API

Lifecycle	Startet, pausiert, beendet, entwirft oder archiviert eine Journey anhand ihrer UUID.
Create and update	Erstellt eine neue Journey-Definition oder ersetzt eine bestehende.
Start by API	Schleust Benutzer in den API-Einstiegspunkt einer laufenden Journey ein.
Get Journey stats	Ruft Statistiken für eine bestimmte Journey anhand ihrer ID ab.
Remove users from journeys	Entfernt einen oder mehrere Benutzer aus allen oder ausgewählten aktiven Journeys.

Scheduled requests API

getResults	Ruft das Ergebnis einer geplanten Anfrage ab.

SMS API

createSMSMessage Veraltet	Erstellt eine neue SMS-Nachricht. Verwenden Sie stattdessen Notify mit platforms: ["SMS"].

WhatsApp API

createWhatsAppMessage Veraltet	Erstellt eine neue WhatsApp-Nachricht. Verwenden Sie stattdessen Notify mit platforms: ["WHATS_APP"].

LINE API

createLineMessage Veraltet	Erstellt eine neue LINE-Nachricht. Verwenden Sie stattdessen Notify mit platforms: ["LINE"].

Kakao API

createKakaoMessage Veraltet	Sendet eine Kakao-Nachricht unter Verwendung einer genehmigten Vorlage. Verwenden Sie stattdessen Notify mit platforms: ["KAKAO"].

Geozones API

getNearestZone	Ruft die Parameter der nächstgelegenen Geozone und die Entfernung dorthin ab. Zeichnet auch den Gerätestandort für Geo-Push-Benachrichtigungen auf.
addGeoZone	Fügt einer bestimmten App eine Geozone hinzu.
updateGeoZone	Aktualisiert Geozone-Eigenschaften wie Name, Status, Inhalt und Reichweite.
deleteGeoZone	Entfernt Geozonen aus der App.
addGeoZoneCluster	Fügt der App einen Geozone-Cluster hinzu.
deleteGeoZoneCluster	Entfernt einen Geozone-Cluster aus der App.
listGeoZones	Ruft eine Liste der Geozonen für die App ab.
listGeoZoneClusters	Ruft eine Liste der Geozone-Cluster für die App ab.