Pushwoosh-API-Übersicht

Die Pushwoosh-API ermöglicht es Entwicklern, mit der Pushwoosh-Plattform zu interagieren.

Was können Sie mit der Pushwoosh-API tun?

Mit der Pushwoosh-API erhalten Sie Zugriff auf eine umfangreiche Bibliothek von über 100 Methoden, die es Ihnen ermöglichen:

• Personalisierte Push-Benachrichtigungen zu senden
• Benutzersegmente für präzises Targeting zu erstellen, zu importieren, zu exportieren und zu verwalten
• Bulk-APIs zu nutzen, um Benutzer/Geräte stapelweise zu verwalten
• Anwendungen zu konfigurieren
• Benutzerereignisse zu verfolgen und Tags zu Benutzern hinzuzufügen, um das Targeting und die Personalisierung zu verbessern
• Pushwoosh-Entitäten wie Voreinstellungen, Tags, Ereignisse, Anwendungen usw. zu erstellen und zu verwalten
• Pushwoosh Customer Journeys über die API zu starten
• Umfassende Statistiken zu Customer Journeys und Push-/E-Mail-/SMS-Kampagnen abzurufen.
• Geofencing zu implementieren, um standortbezogene Benachrichtigungen zu senden, wenn Benutzer bestimmte geografische Gebiete betreten oder verlassen
• Dienste von Drittanbietern nahtlos in Pushwoosh zu integrieren

Um die gesamte Palette der verfügbaren Methoden zu erkunden und die umfangreichen Möglichkeiten der Pushwoosh-API zu entdecken, lesen Sie bitte den Referenzindex der API-Methoden.

Authentifizierung

Die Pushwoosh-API verwendet API-Token zur Authentifizierung von Anfragen. Es gibt zwei Arten von Token: Server und Gerät, die jeweils für bestimmte API-Bereiche verwendet werden.

Jedes Pushwoosh-Konto verfügt über ein standardmäßiges API-Zugriffstoken, das für die Pushwoosh Demo App erstellt wurde. Sie können Ihre API-Token im Pushwoosh Control Panel anzeigen, erstellen und verwalten.

Mehr erfahren

Ratenbegrenzungen

Eine Ratenbegrenzung ist die Anzahl der Anfragen, die die API in einem bestimmten Zeitraum empfangen kann. Während die meisten API-Anfragen in Pushwoosh nicht begrenzt sind, sind /createMessage API-Anfragen auf 600 pro Minute begrenzt, um die Servicequalität für alle Benutzer zu gewährleisten.

Anfragen

HTTPS ist für alle API-Anfragen obligatorisch, um eine sichere Datenübertragung zu gewährleisten.

Antworten

Die Pushwoosh-API gibt typischerweise JSON-Antworten zurück.

Erfolgs- und Fehlercodes

Erfolgscodes

Wenn Ihre API-Anfrage erfolgreich verarbeitet wird, erhalten Sie einen Erfolgscode als Teil der Antwort.

HTTP-Statuscode	Statusmeldung	Beschreibung
200	OK	Pushwoosh hat die Anfrage erfolgreich verarbeitet

Bitte beachten Sie, dass eine HTTP-200-Antwort bedeutet, dass Ihre Anfrage verstanden und erfolgreich verarbeitet wurde, aber nicht den Erfolg der Aktion garantiert. Überprüfen Sie daher auf Fehler- oder Warnmeldungen (Zugriff verweigert, Anwendung nicht gefunden, ungültiger API-Schlüssel usw.), um den Erfolg der Aktion zu bestimmen.

Statuscode	Statusmeldung
200	Warnungen: Sie haben das Abonnentenlimit erreicht. Die Push-Nachricht wird nur an 1 zufälliges Gerät gesendet
200	Warnungen: Sie haben die Anzahl der auf Ihrem aktuellen Abonnementplan erlaubten aktiven Geräte überschritten.
210	Zugriff verweigert oder Anwendung nicht gefunden
210	Anwendung nicht gefunden
210	Anwendung ausgesetzt
210	Konto nicht gefunden
210	Konto wurde gesperrt
210	Gesperrtes Konto kann keine Gerätefilterung verwenden
210	API-Token oder Anwendung ist nicht festgelegt
210	Bitte wählen Sie mindestens eine Plattform aus
210	Ungültiger API-Token: Konto nicht gefunden
210	Kein Anwendungs- oder Gruppencode angegeben
210	API-Token, Anwendung oder Konto ist nicht festgelegt

Fehlercodes

Falls Ihre Anfrage nicht korrekt formatiert ist, auf Verarbeitungsprobleme stößt oder andere Fehler auftreten, sendet Ihnen Pushwoosh einen Fehlercode, der die Art des Problems anzeigt und Ihnen hilft, das Problem effektiv zu beheben.

HTTP-Statuscode	Statusmeldung	Beschreibung
400	Fehlerhafte Anfrage	Die Anfrage kann aufgrund fehlerhafter Syntax nicht erfüllt werden
401	Nicht autorisiert	Die Authentifizierung ist fehlgeschlagen oder wurde nicht bereitgestellt
403	Token-Einschränkungen verbieten diesen Vorgang.	Ihrem Zugriffstoken fehlen die erforderlichen Berechtigungen, um die angeforderte Aktion auszuführen. Um dies zu beheben, überprüfen Sie die Berechtigungen Ihres Zugriffstokens im Pushwoosh Control Panel und passen Sie sie bei Bedarf an die Anforderungen für den spezifischen Vorgang an, den Sie ausführen möchten.
404	Ressource nicht gefunden	Zeigt an, dass die angeforderte Ressource, wie z. B. eine App, nicht gefunden werden konnte oder auf dem Server nicht existiert.
500	Interner Fehler	Es gab ein unerwartetes Problem oder einen Fehler auf dem Server bei der Verarbeitung der API-Anfrage.