# Dein Handy, nur einen curl-Befehl entfernt.

> Sende eine Push-Benachrichtigung aufs Smartphone mit einem einzigen curl-Befehl. POST an die Pocket Alert API aus jedem Terminal, Bash-Skript oder Cronjob – ohne SDK, kostenloser Tarif inklusive.

<!-- source: https://pocketalert.app/de/use-cases/curl-push-notifications -->

Zuletzt aktualisiert: 2026-10-25

Sende eine Push-Benachrichtigung an dein Handy mit einem einzigen curl-Befehl: Sende title und message mit deinem Schlüssel per POST an die Pocket Alert API, und sie landet in unter einer Sekunde auf deinem iPhone oder Android. Funktioniert aus jeder Shell, jedem Skript oder jedem Rechner mit curl.

## Drei Schritte von der Shell in die Tasche

1. **API-Schlüssel holen** — Registriere dich kostenlos, lege auf der Seite API-Schlüssel einen Schlüssel an und exportiere ihn als Umgebungsvariable.
2. **Per curl an die API senden** — Sende title und message per POST an /v1/messages mit dem Token-Header. Form-Daten oder JSON.
3. **Handy vibriert** — Die Push-Benachrichtigung kommt in unter einer Sekunde an. Verknüpfe mit && oder ||, um bei Erfolg oder Fehler benachrichtigt zu werden.

## Von der Konsole aufs Handy

Du arbeitest ohnehin im Terminal. Pocket Alert bringt dein Handy mit einem curl-Befehl dorthin, ohne SDK, ohne Daemon, ohne Benachrichtigungsserver, den du betreiben müsstest.

- **Eine Zeile, kein SDK** — Sende title und message per POST mit einem API-Schlüssel im Header. Kein SDK, kein OAuth, keine Abhängigkeiten außer curl selbst.
- **Gebaut für Shell-Skripte** — Verknüpfe mit && und || für Push bei Erfolg, Fehler oder beidem. Deine Crontab und CI-Skripte kennen das bereits.
- **JSON oder Formularfelder** — JSON oder Form-Daten: Die API erkennt den Content-Type, daher funktionieren sowohl die schnelle Terminal-Variante als auch die skriptbasierte.
- **Priorität pro Nachricht** — Füge level=critical hinzu, um den stillen Modus bei echten Störfällen zu durchbrechen, oder level=silent für ein ruhiges Protokoll ohne Vibration.
- **Verlauf inklusive** — Jede Push-Benachrichtigung landet mit Zustellstatistiken in deinem Verlauf, sodass eine vergessene Skriptnachricht nie wirklich verloren geht.
- **Funktioniert auf jedem Rechner** — Dieselbe Anfrage funktioniert auf einem Raspberry Pi, einem Build-Server, einem VPS oder unter WSL: Überall, wo curl läuft, ist dein Handy erreichbar.

## Sende eine Push-Benachrichtigung aus dem Terminal

### 1. Der Einzeiler

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Deploy finished' -F 'message=v2.4.1 is live on production'
```

Lege einen Schlüssel auf der Seite [API-Schlüssel](https://pocketalert.app/de/account/apikeys) an. JSON funktioniert auch, falls du das bevorzugst:

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

### 2. Verknüpfe es mit allem

Benachrichtige dich, wenn ein langsamer Job fertig ist, oder nur dann, wenn er fehlschlägt:

```
# push when the build succeeds
make release && curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' -F 'title=Build OK' -F 'message=make release finished'

# push only on failure, and make it loud
./migrate.sh || curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Migration FAILED' -F 'message=migrate.sh exited non-zero' -F 'level=critical'
```

### 3. In eine Funktion packen

Füge dies in deine `.bashrc` / `.zshrc` ein und tippe die URL nie wieder ein:

```
notify() {
  curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
    -H "Token: $POCKETALERT_KEY" \
    --form-string "title=$1" --form-string "message=$2" --form-string "level=${3:-default}" > /dev/null
}

# usage
long_task; notify "long_task done" "exit code $?"
notify "Disk warning" "/dev/sda1 at 91%" high
```

Lieber ein echtes Binary? Die [Pocket Alert CLI](https://pocketalert.app/de/tools/cli) kapselt dieselbe API. Und da es reines HTTP ist, funktioniert derselbe Aufruf aus Python, Go, PowerShell oder einem [Cronjob](https://pocketalert.app/de/use-cases/cron-job-alerts).

## FAQ

### Wie sieht der minimale curl-Befehl für eine Push-Benachrichtigung aus?

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. Mehr braucht es nicht: kein SDK, keine Client-Bibliothek, kein OAuth-Theater. Jeder Rechner mit curl kann senden.

### Nimmt die API JSON oder Formularfelder entgegen?

Beides. Der Endpunkt akzeptiert application/json und Form-Daten (-d key=value-Paare) und erkennt automatisch, was du gesendet hast. Form-Daten sind im Terminal schneller getippt; JSON ist einfacher, wenn du es programmatisch erzeugst.

### Wie werde ich benachrichtigt, wenn ein langlaufender Befehl fertig ist?

Hänge deinen Befehl mit && an: make build && curl … wird nur bei Erfolg ausgeführt. Nutze || für Fehlermeldungen oder ; für eine Benachrichtigung in jedem Fall. Bei langen Jobs speicherst du den Exit-Code und schreibst ihn in die Nachricht, damit die Push-Benachrichtigung dir sagt, was passiert ist.

### Kann ich die Priorität über die Kommandozeile setzen?

Füge -F 'level=critical' hinzu, und die Push-Benachrichtigung umgeht unter Android den Modus Nicht stören und setzt sich auf dem iPhone gegen den Fokus durch. Mit level=silent erhältst du Hinweise, die protokolliert werden, ohne Ton. Es gibt fünf Stufen: silent, low, default, high, critical.

### Woher kommt der API-Schlüssel?

Lege einen auf der Seite API-Schlüssel an, nachdem du dich registriert hast. Speichere ihn in einer Umgebungsvariable oder in deinem Secrets-Manager, statt ihn fest in Skripte zu schreiben. Der kostenlose Tarif umfasst 50 Nachrichten pro Tag, genug für einen arbeitsreichen Tag voller Skripte.
