# So funktionieren Push-Benachrichtigungen: APNs und FCM erklärt

> Jede Push-Benachrichtigung an ein iPhone läuft über Apples APNs, fast jede an Android über Googles FCM. Gerätetoken, Authentifizierung beim Dienst, die Anfrage selbst, was passiert, wenn das Handy offline ist, und wie Priorität auf jeder Plattform wirklich funktioniert.

*05.10.2026*

<!-- source: https://pocketalert.app/de/blog/how-push-notifications-work-apns-fcm -->

Eine Push-Benachrichtigung wirkt von außen einfach: Auf einem Server passiert etwas, und eine Sekunde später leuchtet das Handy auf. Dazwischen liegen zwei Zustellnetzwerke, betrieben von Apple und Google, und keine Nachricht erreicht ein Handy, ohne einen von beiden zu durchlaufen.

- **APNs**, der Apple Push Notification Service, liefert jede Push-Benachrichtigung an iPhone, iPad, Mac und Apple Watch.
- **FCM**, Firebase Cloud Messaging, liefert an Android-Geräte mit Google-Play-Diensten und kann auch an iOS senden, indem Nachrichten an APNs weitergereicht werden.

Dieser Leitfaden verfolgt eine Benachrichtigung vom Server bis zum Sperrbildschirm auf beiden Plattformen, mit den Details, die erst im Produktivbetrieb auftauchen. Wir betreiben beide Pipelines hinter [Pocket Alert](/), deshalb stammen die Beispiele aus dem, was wir tatsächlich ausliefern.

## Die vier Beteiligten

1. **Dein Server**, den Apple Provider nennt. Er entscheidet, dass etwas gesendet werden soll.
2. **Der Push-Dienst**, APNs oder FCM. Er nimmt die Anfrage an und leitet sie weiter.
3. **Das Gerät.** Das Betriebssystem hält eine langlebige, verschlüsselte Verbindung zu Apple oder Google offen und empfängt darüber Pushes für alle Apps.
4. **Die App.** Sie hat sich für Benachrichtigungen registriert und besitzt das Token, an das der Push adressiert ist.

Der dritte Punkt erklärt, warum Push akkuschonend ist. Das Handy fragt deinen Server nie ab. Eine einzige Verbindung, geteilt von allen Apps, bleibt offen, und der Push-Dienst sendet darüber, wenn es etwas zuzustellen gibt.

## Schritt 1: Das Gerät bekommt ein Token

Wenn sich eine App für Remote-Benachrichtigungen registriert, gibt ihr das Betriebssystem ein Token: eine undurchsichtige Adresse für „diese App auf diesem Gerät". Die App schickt das Token an deinen Server, und dein Server speichert es.

- Ein **APNs-Gerätetoken** ist an App und Gerät gebunden. Apple empfiehlt, es nicht in der App zwischenzuspeichern: Es ändert sich, wenn ein Nutzer aus einem Backup wiederherstellt, auf ein neues Gerät wechselt oder das System neu installiert.
- Ein **FCM-Registrierungstoken** hat auf Android dieselbe Rolle, und FCM erneuert es nach eigenem Zeitplan.

Tokens veralten ständig. Gespeicherte Tokens aktuell zu halten, ist ein großer Teil des Betriebs von Push.

## Schritt 2: Dein Server weist sich aus

### APNs

APNs spricht HTTP/2 über TLS 1.2 oder neuer, unter `api.push.apple.com` für Produktion und `api.sandbox.push.apple.com` für Entwicklungs-Builds, auf Port 443 oder 2197. Es gibt zwei Wege zur Authentifizierung:

- **Token-basiert.** Du erstellst in deinem Apple-Developer-Account einen `.p8`-Signierschlüssel und signierst damit ein kurzlebiges JWT mit ES256, das deine Team-ID und die Schlüssel-ID enthält. Apple möchte, dass dieses JWT höchstens alle 20 Minuten und spätestens alle 60 Minuten erneuert wird. Ein zu altes JWT führt zu `403 ExpiredProviderToken`, zu häufiges Erneuern zu `429 TooManyProviderTokenUpdates`.
- **Zertifikatsbasiert.** Ein TLS-Client-Zertifikat pro App, ein Jahr gültig und danach zu erneuern.

Token-Authentifizierung ist die empfohlene Variante. Ein einziger Schlüssel deckt alle deine Apps ab und läuft nicht jedes Jahr ab.

### FCM

Die HTTP-v1-API von FCM verlangt ein kurzlebiges OAuth-2.0-Zugriffstoken eines Google-Dienstkontos mit dem Scope `firebase.messaging`. Die ältere „Legacy"-API mit statischem Serverschlüssel wurde 2023 als veraltet markiert und ab Juli 2024 abgeschaltet. Code, der noch `Authorization: key=...` sendet, funktioniert daher nicht mehr.

## Schritt 3: Die Anfrage

### Senden an APNs

Jeder Push ist ein HTTP/2-POST an `/3/device/<device token>`, mit ein paar Headern, die die Verarbeitung beeinflussen:

```bash
curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
```

- `apns-topic` ist die Bundle-ID deiner App.
- `apns-push-type` legt fest, um welche Art Push es sich handelt: `alert` für eine sichtbare Benachrichtigung, `background` für einen stillen Daten-Push und ein paar weitere.
- `apns-priority` ist `10` für sofortige Zustellung, `5` für eine Zustellung, die der Energiezustand des Geräts bestimmt, oder `1` für Energieschonung ohne Aufwecken des Geräts.
- `apns-expiration` legt fest, wie lange APNs weiterversuchen soll. `0` bedeutet einen Versuch und keine Speicherung.
- `apns-collapse-id` erlaubt, dass eine neuere Benachrichtigung eine ältere mit derselben ID ersetzt.

Die Nutzlast ist JSON mit einem `aps`-Dictionary und auf **4 KB** begrenzt (5 KB für VoIP).

### Senden an FCM

FCM nimmt pro Anfrage eine JSON-Nachricht entgegen:

```bash
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'
```

Eine `notification`-Nachricht zeigt das System an, wenn die App im Hintergrund läuft. Eine `data`-Nachricht wird an die App zur Verarbeitung übergeben. In beiden Fällen gilt die Grenze von **4.096 Bytes** für die Nutzlast.

## Schritt 4: Zustellung oder Warten darauf

Ist das Handy online, läuft der Push über die offene Verbindung und erscheint innerhalb von Augenblicken. Ist es das nicht:

- **APNs** speichert die Benachrichtigung je nach `apns-expiration` bis zu 30 Tage, behält aber **nur eine Benachrichtigung pro App und Gerät**. Schickst du fünf, während das Handy im Flugmodus ist, sieht es meist nur die letzte. Apple garantiert nicht einmal, dass es die neueste ist.
- **FCM** behält Nachrichten für ihre Lebensdauer (Time to Live), standardmäßig vier Wochen und höchstens 28 Tage. Ersetzbare Nachrichten überschreiben einander, mit bis zu vier Collapse-Keys pro Gerät.

Auch die Priorität beeinflusst das Timing. Unter iOS können Pushes mit Priorität `5` und `1` gebündelt, gedrosselt oder verworfen werden. Unter Android können Nachrichten mit `normal`-Priorität warten, bis das Gerät den Doze-Modus verlässt, während `high`-Nachrichten sofort zugestellt werden. FCM achtet außerdem darauf, wie du dieses Privileg nutzt: Nachrichten mit hoher Priorität, die keine sichtbare Benachrichtigung auslösen, werden mit der Zeit stillschweigend auf normal herabgestuft.

## Wie laut es ist: Unterbrechungsstufen und Kanäle

Zustellung ist das eine. Ob das Handy einen Ton abspielt, ist etwas anderes, und die beiden Plattformen handhaben das unterschiedlich.

**iOS** (ab 15) gibt jeder Benachrichtigung eine Unterbrechungsstufe:

- `passive` fügt sie der Liste hinzu, ohne den Bildschirm zu aktivieren oder einen Ton abzuspielen.
- `active` ist der Standard.
- `time-sensitive` kann sich gegen Fokus und die Benachrichtigungsübersicht durchsetzen. Nutzer können das pro App abschalten.
- `critical` wird immer abgespielt, auch bei Nicht stören und eingeschaltetem Stummschalter. Dafür ist ein Berechtigungsanspruch nötig, den Apple auf Anfrage nach Prüfung gewährt.

**Android** (ab 8) ordnet jede Benachrichtigung einem **Kanal** zu, und der Kanal bestimmt die Wichtigkeit: Ton, Vibration, Anzeige als Banner und das Verhalten bei Nicht stören. Die App legt Kanäle an, aber sobald ein Kanal existiert, liegt sein Verhalten beim Nutzer. Die App kann es später nicht mehr ändern.

Diese letzte Regel hat reale Folgen. Als wir Pocket Alerts kritische Warnungen auch im Stummmodus klingeln lassen wollten, ließ sich der bestehende kritische Kanal nachträglich nicht auf Alarmton umstellen. Die Lösung war ein zweiter Kanal mit neuer ID. Der Server wählt ihn nur für App-Versionen aus, die ihn anlegen, denn an einen Kanal zu senden, den die App nie angelegt hat, bedeutet, dass die Benachrichtigung überhaupt nicht angezeigt wird.

Auf Android 13 und neuer gibt es eine weitere Hürde: Die App braucht die Laufzeitberechtigung `POST_NOTIFICATIONS`, und bei einer frischen Installation bleiben Benachrichtigungen aus, bis der Nutzer sie erteilt.

## Was im Produktivbetrieb schiefgeht

- **Veraltete Tokens.** APNs antwortet mit `410 Unregistered` auf ein Token, das nicht mehr gültig ist. Sende nicht mehr an dieses Token und lösche es.
- **Falsche Umgebung.** Das Token eines Entwicklungs-Builds, an den Produktionshost gesendet, schlägt mit `400 BadDeviceToken` fehl.
- **Zu große Nutzlasten.** `413 PayloadTooLarge`, sobald du 4 KB überschreitest. Lange Logzeilen im Text einer Warnung sind die häufigste Ursache.
- **Herabgestufte Priorität.** Android-Nachrichten mit hoher Priorität, die nie etwas anzeigen, verlieren ihre Priorität.
- **Benachrichtigungen ausgeschaltet.** Der Push wird zugestellt, aber der Nutzer sieht ihn nie, weil die Berechtigung abgelehnt wurde oder der Kanal stummgeschaltet ist.

## Die Abkürzung

All das lohnt sich, wenn die App dein Produkt ist und du an ihre Nutzer sendest. Für Warnungen an dich selbst oder dein Team ist es sehr viel Infrastruktur: ein Entwicklerkonto auf jeder Plattform, Signierschlüssel, Token-Speicherung, zwei Anfrageformate und zwei Prioritätsmodelle.

Ein Push-Benachrichtigungsdienst betreibt beide Pipelines für dich. Mit Pocket Alert sendest du eine einzige Anfrage, ohne eigene Tokens oder Zertifikate:

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
```

Das Feld `level` wird für jede Plattform übersetzt:

- `silent` ist auf dem iPhone eine passive Benachrichtigung ohne Ton und geht auf Android in einen stillen Kanal.
- `low` ist auf dem iPhone passiv und auf Android von niedriger Wichtigkeit.
- `default` ist auf beiden eine normale Benachrichtigung.
- `high` ist auf dem iPhone zeitkritisch und auf Android mit hoher Priorität.
- `critical` umgeht auf Android Nicht stören. Auf dem iPhone kommt sie als zeitkritisch an, und der volle kritische Alarmton wird ausgerollt, sobald Apple die Berechtigung gewährt.

Mehr dazu unter [kritische Warnungen](/use-cases/critical-alerts), und zur API selbst unter [Was ist eine Push-Benachrichtigungs-API](/blog/what-is-a-push-notification-api).

## FAQ

### Garantiert APNs die Zustellung?

Nein. APNs und FCM arbeiten beide nach bestem Bemühen. APNs speichert für ein Offline-Gerät nur die neueste Benachrichtigung, und keiner der beiden Dienste garantiert, wann eine Nachricht ankommt. Googles Dokumentation geht weiter und sagt, FCM sollte nicht für lebenswichtige Notfallwarnungen verwendet werden. Für Bereitschaftsalarme gilt: Betrachte Push als schnellsten Kanal, nicht als einzigen.

### Warum brauche ich sowohl APNs als auch FCM?

iPhones akzeptieren Pushes nur über APNs. Android-Geräte mit Google-Play-Diensten empfangen sie über FCM. Wenn deine Nutzer auf beiden Plattformen sind, spricht dein Server mit beiden, entweder direkt oder über FCM, das für dich an APNs weiterleiten kann.

### Kann FCM Benachrichtigungen an ein iPhone senden?

Ja. Du lädst deinen APNs-Authentifizierungsschlüssel in Firebase hoch, und FCM liefert an iOS, indem es die Nachricht an APNs weitergibt. Datennachrichten an Apple-Geräte müssen mit normaler Priorität gesendet werden.

### Wie groß darf eine Push-Benachrichtigung sein?

4 KB für eine APNs-Nutzlast (5 KB für VoIP-Pushes) und 4.096 Bytes für eine FCM-Nachricht. Langer Text gehört in deine App oder einen Link, nicht in den Push.

### Was ist ein Gerätetoken?

Eine Adresse für eine App auf einem Gerät, ausgestellt von Apple oder Google. Dein Server sendet Pushes an diese Adresse. Sie kann sich jederzeit ändern, daher müssen Server aktualisierte Tokens übernehmen und jene verwerfen, die APNs oder FCM als ungültig melden.

[Erstelle ein kostenloses Pocket-Alert-Konto](/signup), um Schlüssel und Tokens zu sparen, oder sieh dir unter [Alternativen](/alternatives) an, wie andere Dienste abschneiden.
