Zurück zum Blog

Was ist eine Push-Benachrichtigung-API, und wann brauchst du sie?

Was ist eine Push-Benachrichtigung-API, und wann brauchst du sie?

Eine Push-Benachrichtigung-API ist ein Webservice, der eine Nachricht auf dem Sperrbildschirm eines Handys anzeigt, sobald dein Code sie anfordert. Du schickst eine HTTP-Anfrage mit einem Titel und einem Text, der Dienst übergibt sie an Apple oder Google, und das Handy zeigt sie innerhalb von Sekunden an, egal ob gerade eine App geöffnet ist oder nicht.

Das ist die ganze Idee. Die Details stecken darin, für wen die Push-Benachrichtigung gedacht ist und wie viel von der Zustellkette du selbst kontrollieren willst.

Zwei verschiedene Dinge teilen sich den Namen

Suchst du nach „push notification API“, findest du zwei Arten von Produkten, die sich kaum überschneiden.

Plattformen, die an deine Nutzer pushen. Firebase Cloud Messaging, Apple Push Notification service, OneSignal und ähnliche. Du baust eine mobile App, veröffentlichst sie im App Store und bei Google Play, sammelst von jeder Installation ein Gerätetoken und verschickst Produkt- oder Marketing-Push-Benachrichtigungen an Tausende Menschen. Die API ist der letzte Schritt eines größeren Projekts.

Dienste, die an dich pushen. Pocket Alert, Pushover, ntfy und andere. Die App existiert bereits: Du installierst sie auf deinem eigenen Handy, holst dir einen API-Schlüssel und schickst Benachrichtigungen aus Skripten, Servern und anderen Diensten. Nichts zu veröffentlichen, keine Tokens zu sammeln. Ein Deployment ist fertig, ein Backup ist fehlgeschlagen, eine Zahlung ist eingegangen.

Dieser Leitfaden handelt von der zweiten Art. Wenn du eine Consumer-App baust und deren Nutzer erreichen willst, brauchst du die erste Art, und das meiste hier Folgende trifft dann nicht auf dich zu.

Was passiert, wenn du eine Push-Benachrichtigung sendest

Vier Schritte, die meisten davon unsichtbar:

  1. Dein Code sendet eine HTTPS-Anfrage mit Titel, Nachricht und deinem API-Schlüssel an den Dienst.
  2. Der Dienst prüft den Schlüssel, speichert die Nachricht und entscheidet, wohin sie geht: auf welche deiner Geräte und mit welcher Priorität.
  3. Er übergibt die Push-Benachrichtigung an das eigene Push-Netzwerk der Plattform, APNs für iPhone und Firebase Cloud Messaging für Android.
  4. Apple oder Google liefert sie über die Verbindung zu, die jedes Handy ohnehin dauerhaft zu ihnen offen hält, und das Handy zeigt sie an.

Die Schritte 3 und 4 sind der Grund, warum Push auch funktioniert, wenn die App geschlossen ist, und den Akku nicht leersaugt: Das Handy fragt nie aktiv bei jemandem nach. Den vollständigen Weg beschreibt So funktionieren Push-Benachrichtigungen: APNs und FCM.

Warum nicht direkt mit Apple und Google sprechen?

Du kannst das, wenn du eine eigene App in beiden Stores hast. Um ohne Zwischenstation auf dein eigenes Handy zu pushen, bräuchtest du:

  • Eine Mitgliedschaft im Apple Developer Program und eine iOS-App mit der Push-Berechtigung, dazu ein Firebase-Projekt und eine Android-App für die andere Seite.
  • Einen APNs-Signaturschlüssel und ein Firebase-Dienstkonto sowie Code, der die Anfragen für jede Plattform signiert.
  • Eine Möglichkeit, Gerätetokens aus der App einzusammeln und aktuell zu halten, wenn sie sich ändern.
  • Zwei Anfrageformate, zwei Prioritätsmodelle und zwei Sätze an Fehlercodes.

Das ist ein vernünftiges Projekt, wenn die App dein Produkt ist. Für „sag mir Bescheid, wenn der Cronjob fehlschlägt“ ist das enorm viel Aufwand. Ein Push-Benachrichtigungsdienst hat all das einmal für alle erledigt.

So sieht eine Anfrage aus

Mit Pocket Alert ist das Senden einer Push-Benachrichtigung ein einziger authentifizierter POST:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'

Die Antwort ist 201 Created mit der gespeicherten Nachricht und der Priorität, mit der sie versendet wurde. Dieselbe Anfrage funktioniert in jeder Sprache mit einem HTTP-Client, und Push-Benachrichtigungen mit curl senden enthält weitere Rezepte für das Terminal.

Nur title und message sind Pflichtfelder. Die optionalen Felder, die bei Alarmen am meisten zählen:

  • level legt fest, wie laut sie ankommt: silent, low, default, high oder critical.
  • actions fügt der Benachrichtigung bis zu drei Aktionsbuttons hinzu: eine URL öffnen, eine HTTP-Anfrage auslösen oder einen Wert kopieren.
  • send_at oder delay verschickt sie später statt sofort (in kostenpflichtigen Tarifen).
  • application_id und device_id bestimmen, zu welcher Anwendung sie gehört und welches Handy sie bekommt.

Drei Wege hinein, nicht nur die API

Eine Push-Benachrichtigung-API ist am nützlichsten, wenn du nicht für jede Quelle Code schreiben musst.

  • Die HTTP-API für deine eigenen Skripte, Jobs und Apps.
  • Webhook-URLs für Dienste, die ohnehin Webhooks senden. GitHub, Stripe, Grafana oder Sentry schicken ihr eigenes JSON an eine Pocket-Alert-Webhook-URL, und Platzhalter wie %repository.name% ziehen einzelne Felder daraus in die Push-Benachrichtigung, ganz ohne Code dazwischen. Erstelle deine erste Webhook-URL zeigt dir Schritt für Schritt, wie das geht.
  • Die CLI und der MCP-Server für das Terminal und für KI-Agenten: pocketalert send "Build done" "All tests passed" aus einer Shell (CLI), oder ein create_message-Tool, das Claude oder Cursor aufruft, wenn eine lange Aufgabe endet (MCP).

Wofür du eine verwenden würdest

Die meisten Benachrichtigungen fallen in ein paar Gruppen:

Das Gemeinsame ist ein Ereignis, von dem jemand jetzt erfahren sollte und nicht erst beim nächsten Öffnen eines Dashboards oder Posteingangs.

Worauf du achten solltest, bevor du dich entscheidest

Jeder Dienst in diesem Bereich verschickt eine Push-Benachrichtigung aus einer HTTP-Anfrage. Die Unterschiede liegen im Drumherum:

  • Plattformen. Manche gibt es nur für iPhone (Bark, The Notification App), und Gotifys einzige offizielle App ist für Android. Wenn die Person, die den Alarm braucht, das andere Handy hat, ist die Entscheidung damit gefallen.
  • Prioritätsstufen. Darf ein fehlgeschlagenes Backup anders klingen als eine neue Registrierung? Kommt ein kritischer Alarm auch durch „Nicht stören“?
  • Eingehende Webhooks. Kann ein Dienst sein eigenes JSON senden, oder braucht jede Quelle ein Skript, das die Daten umformt?
  • Verlauf und Protokolle. Wenn ein Alarm nicht angekommen ist: Gibt es einen Eintrag zum Aufruf und dazu, was damit passiert ist?
  • Limits und Preise. Pro Tag, pro Monat oder insgesamt, und was passiert, wenn du das Limit erreichst.
  • Wer betreibt ihn. Ein gehosteter Dienst oder ein Server, den du selbst pflegst.

Wie Pocket Alert im Vergleich zu Pushover, ntfy, Pushbullet, Bark, Gotify und anderen bei genau diesen Punkten abschneidet, zeigen wir in den Alternativen, auch dort, wo jeweils ein anderer Dienst die bessere Wahl ist.

FAQ

Ist eine Push-Benachrichtigung-API dasselbe wie Firebase Cloud Messaging?

FCM ist eine Push-Benachrichtigung-API: die, die Google für Apps bereitstellt, die du selbst baust und veröffentlichst. Dienste wie Pocket Alert setzen auf FCM und APNs auf und kümmern sich um die App, die Schlüssel und die Gerätetokens, sodass du nur die HTTP-Anfrage erstellst.

Muss ich eine mobile App bauen?

Nicht für Benachrichtigungen an dich selbst oder dein Team. Du installierst eine bestehende App, etwa Pocket Alert für iPhone oder Android, und sendest an sie. Eine eigene App brauchst du nur, wenn du an deine eigenen Nutzer pushen willst.

Ist es kostenlos?

Viele Dienste haben einen kostenlosen Tarif. Der von Pocket Alert erlaubt 50 Nachrichten am Tag ohne Kreditkarte, was für die meisten persönlichen Benachrichtigungen reicht. Kostenpflichtige Tarife beginnen bei 6 $ im Monat für 1.000 am Tag. Details findest du auf der Preisseite.

Wie schnell wird zugestellt?

Meist wenige Sekunden von der Anfrage bis zum Sperrbildschirm. Apple und Google garantieren das Timing jedoch nicht: Ein Handy ohne Empfang oder im strikten Energiesparmodus bekommt die Benachrichtigung, sobald es wieder verbunden ist.

Push, SMS oder E-Mail?

Push für Dinge, die jetzt Aufmerksamkeit brauchen, E-Mail für Zusammenfassungen und Protokolle, SMS, wenn die Person gar keine Smartphone-App nutzen kann. Die Abwägungen beschreiben Push-Benachrichtigungen vs. SMS und Push-Benachrichtigungen vs. E-Mail-Alarme.

Erstelle ein kostenloses Konto, kopiere deinen API-Schlüssel, und der curl-Befehl oben ist deine erste Push-Benachrichtigung.

Artikel teilen