# Sende eine Push-Benachrichtigung von deinem Backend.

> Sende Push-Benachrichtigungen aus deinem Backend mit der Pocket Alert API. Ein authentifizierter HTTP-POST aus Node, Python, PHP oder Go landet in einer Sekunde auf deinem Smartphone.

<!-- source: https://pocketalert.app/de/use-cases/api-alerts -->

Zuletzt aktualisiert: 2026-08-11

Die Pocket Alert API sendet mit einem einzigen authentifizierten HTTP-POST eine Push-Benachrichtigung auf dein Handy. Sende sie aus Node, Python, PHP oder Go, mit Titel, Nachricht und Prioritätsstufe, und sie landet fast sofort auf deinem iPhone oder Android.

## Drei Schritte zu deiner ersten API-Push-Benachrichtigung

1. **Hol dir einen API-Schlüssel** — Erstelle einen API-Schlüssel auf der Seite API-Schlüssel und speichere ihn in einer Umgebungsvariable.
2. **Sende einen Request** — Sende Titel und Nachricht als JSON per POST an den Messages-Endpunkt, den Schlüssel im Token-Header.
3. **Ab damit** — Dein Handy vibriert innerhalb einer Sekunde. Füge Targeting für Anwendungen und Geräte hinzu, sobald du es brauchst.

## Push-Benachrichtigungen, nur einen Request entfernt

Die API steckt hinter jeder Pocket Alert Benachrichtigung. Binde sie mit einem einzigen Request in dein Backend ein.

- **Reines REST, kein SDK** — Ein authentifizierter POST sendet eine Push-Benachrichtigung aus dem HTTP-Client, den du schon nutzt. Kein SDK, keine Queue, kein Broker.
- **Jede Sprache** — Node, Python, PHP, Go und Ruby können alle eine Pocket Alert Push-Benachrichtigung auslösen.
- **Schlüsselbasierte Authentifizierung** — Dein API-Schlüssel wird über HTTPS im Token-Header übertragen. Erstelle, begrenze und rotiere Schlüssel nach deinem eigenen Zeitplan.
- **Volle Kontrolle** — Leite mit application_id weiter und sprich mit device_id ein einzelnes Gerät an, oder lass es weg, um alle Geräte zu erreichen. Alles in einem Aufruf.
- **Zustellung in unter einer Sekunde** — Push-Benachrichtigungen erreichen dein iPhone oder Android in deutlich unter einer Sekunde, schnell genug für Echtzeit-Alarme aus dem Backend.
- **CLI & Webhook bereit** — Dieselbe API steckt hinter der CLI und den Webhooks. Starte mit Code und ergänze später eines von beiden.

## Sende deine erste API-Benachrichtigung

### 1. Hol dir einen API-Schlüssel

Erstelle einen Schlüssel auf der Seite [API-Schlüssel](https://pocketalert.app/de/account/apikeys) und sende ihn bei jedem Request im `Token`-Header.

### 2. Sende eine Nachricht per POST

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. Aus deinem Code

Rufe es dort auf, wo ein Endpunkt Fehler liefert oder ein eigenes Ereignis auftritt, zum Beispiel nach einem fehlgeschlagenen Health-Check oder einer neuen Bestellung:

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

Die vollständige [Einstiegsdokumentation](https://info.pocketalert.app/getting-started.html) erklärt das Targeting für Anwendungen und Geräte.

## FAQ

### Wie sende ich eine Push-Benachrichtigung per API?

Sende einen POST an die Messages-API von Pocket Alert, deinen Schlüssel im Token-Header und einen JSON-Body mit Titel und Nachricht. Die Push-Benachrichtigung landet sofort auf deinem Handy.

### Wie funktioniert die API-Authentifizierung?

Authentifiziere dich mit einem API-Schlüssel von der Seite Einstellungen. Er wird über HTTPS im Token-Header übertragen. Erstelle und rotiere Schlüssel, wann immer du willst, und begrenze Benachrichtigungen pro Anwendung.

### Welche Sprachen werden unterstützt?

Jede Sprache, die HTTP-Requests stellen kann, funktioniert: Node, Python, PHP, Go, Ruby und Rust. Du musst nichts installieren, sondern machst einfach einen REST-Aufruf mit dem HTTP-Client, den du schon nutzt.

### Was kann ich im Request steuern?

Lege Titel und Nachricht fest, leite mit application_id an eine bestimmte Anwendung weiter, sprich mit device_id ein einzelnes Gerät an (oder lass es weg, um alle Geräte zu erreichen) und setze die Priorität mit level, von silent bis critical. Eine critical-Nachricht durchbricht auf Android den Modus Nicht stören und auf dem iPhone den Fokus.

### Gibt es auch eine CLI- oder Webhook-Option?

Ja. Die Pocket Alert CLI bietet dieselbe API für Skripte und CI. Wenn du lieber ohne Code arbeitest, erstelle einen Webhook und richte einen Dienst auf dessen Empfangs-URL aus.
