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

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.

Nachrichten-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 ein neues Push-Preset.
List	Listet die Push-Presets einer Anwendung auf.
Get	Ruft ein einzelnes Push-Preset anhand des Codes ab.
Update	Überschreibt ein Push-Preset anhand des Codes.
UpdatePartial	Aktualisiert nur die angegebenen Felder eines Push-Presets anhand des Codes.
Clone	Dupliziert ein Push-Preset innerhalb derselben Anwendung.
Delete	Löscht ein Push-Preset anhand des Codes.

Geräte-API

registerDevice	Registriert ein Gerät für die Anwendung.
unregisterDevice	Entfernt den 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-Öffnungs-Ereignis.
pushStat	Registriert ein Push-Öffnungs-Ereignis.
messageDeliveryEvent	Registriert ein Push-Zustellungs-Ereignis 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.

Segmentierungs- (Filter-) 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.

Benutzerzentrierte 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.

Anwendungs-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.

Kampagnen-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-Konfigurations-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.

E-Mail-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.

E-Mail-Vorlagen-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 anhand des Codes zurück.
Update	Aktualisiert eine bestehende E-Mail-Vorlage anhand des Codes.
Delete	Löscht eine E-Mail-Vorlage und das zugehörige Preset anhand des Codes.
Clone	Klont eine E-Mail-Vorlage in eine Zielanwendung.

Testgeräte-API

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

Nachrichten-Posteingangs-API

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

Statistik-API

Nachrichtenstatistiken

messages:list	Ruft eine Liste der gesendeten Nachrichten ab.
totalsByIntervals	Liefert Metriken und Konversionsdaten, aggregiert nach Stunden.
getMessageLog	Ruft detaillierte Informationen über gesendete Nachrichten ab.
linksInteractions	Liefert Statistiken zu Klicks auf E-Mail-Links.
linksInteractionsDevices	Listet Benutzer auf, die auf Links in E-Mails geklickt haben.
bouncedEmails	Liefert Informationen zu E-Mail-Bounces, Beschwerden und Bounce-Gründen.

Asynchroner Export von Nachrichtenstatistiken

exportMessagesStatistics/export	Stellt einen Export des Nachrichtenverlaufs 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 anhand des Namens herunter.

Anwendungs- und Abonnentenstatistiken

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.

Kampagnenstatistiken

getCampaignStats	Ruft Kampagnenstatistiken für einen bestimmten Zeitraum ab.

Ereignis- und Tag-Statistiken

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-Statistiken

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 für den Zeitraum 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.

API für geplante Anfragen

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.