Die iOS-Live-Aktivitäten-API für alles, was HTTP spricht
PushWard ist eine API für Apples Live-Aktivitäten: Sende eine einzige HTTP-Anfrage und sie erscheint live auf dem iPhone-Sperrbildschirm und in der Dynamic Island, aktualisiert sich in Echtzeit und räumt sich selbst weg, wenn die Aufgabe erledigt ist. Kein ActivityKit-Code, kein Xcode, kein App Store Review auf deiner Seite.
Was ist eine Live-Aktivität?
Eine Live-Aktivität ist eine iOS-Funktion, die live und auf einen Blick erfassbare Informationen auf dem Sperrbildschirm, in der Dynamic Island und im Standby anzeigt — ohne dass der Empfänger je eine App öffnet. Anders als eine Push-Benachrichtigung, die einmal erscheint und in der Liste untergeht, bleibt eine Live-Aktivität angeheftet und aktualisiert sich in Echtzeit: ein Build, der seine Schritte durchläuft, ein Timer, der herunterzählt, eine Lieferung, die näher kommt. PushWard macht aus einer einzigen HTTP-Anfrage genau das.
Apples Live-Aktivitäten, ohne ActivityKit
Live-Aktivitäten sind eine mit iOS 16.1 eingeführte iOS-Funktion von Apple: auf einen Blick erfassbare Echtzeit-Flächen, angeheftet an den Sperrbildschirm und die Dynamic Island. Eine zu bauen heißt normalerweise, eine eigene iOS-App mit einer ActivityKit-Widget-Extension auszuliefern, Push-to-Start-Tokens anzufordern und selbst mit APNs zu sprechen. PushWard ersetzt all das durch eine REST API: Die PushWard-App rendert deine Live-Aktivität, und eine einzige HTTP-Anfrage startet, aktualisiert oder beendet sie.
So funktioniert die API
Erstelle eine Aktivität, starte, aktualisiere und beende sie — alles über die REST API von PushWard mit deinem Integrationsschlüssel. Jeder Dienst, der eine HTTP-Anfrage senden kann, steuert, was Menschen auf einen Blick sehen. Es gibt keine APNs-Zertifikate und keinen Client-Code zu schreiben; PushWard übernimmt die Zustellung über den Apple Push Notification service.
# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "slug": "deploy", "name": "Deploy to production" }'
# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ongoing", "content": {
"template": "generic", "progress": 0.2,
"state": "Building...", "accent_color": "cyan"
} }'
# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ended", "content": {
"template": "generic", "progress": 1, "state": "Deployed"
} }'Eine Vorlage für jede Art von Update
Wähle aus Live-Aktivitäten-Vorlagen für unterschiedliche Aufgaben — ein generischer Fortschrittsbalken, ein Countdown, eine Schrittabfolge, ein Alert, ein Gauge, eine Timeline-Sparkline, ein Board aus Kacheln oder ein Live-Ereignisprotokoll. Jede hat ein Layout, das auf Sperrbildschirm und Dynamic Island abgestimmt ist.
Funktioniert mit deinem Stack
Sende Live-Aktivitäten direkt aus den Tools, die du ohnehin betreibst. Fertige Bridges und ein gehostetes Webhook-Relay decken Grafana-Alerts, Home-Assistant-Automationen, GitHub Actions, SABnzbd-Downloads, Bambu-Lab-Drucke, ArgoCD-Syncs und alles andere ab, was JSON senden kann.
Häufig gestellte Fragen
Ist das die offizielle Live-Aktivitäten-API von Apple?
Nein. Apples offizielles Framework ist ActivityKit, das den Bau und die Auslieferung einer eigenen iOS-App voraussetzt. PushWard ist eine unabhängige iOS-Live-Aktivitäten-API: Sie stellt deine Updates über den Apple Push Notification service an die PushWard-App zu, die sie auf dem Sperrbildschirm und in der Dynamic Island rendert.
Kann ich eine Live-Aktivität von einem Server aus starten?
Ja — genau darum geht es. Jeder Server, jedes Skript und jede Automatisierung, die eine HTTP-Anfrage senden kann, kann eine Live-Aktivität erstellen, starten, aktualisieren und beenden. PushWard übernimmt Apples Push-to-Start-Ablauf für dich, sodass die Aktivität erscheint, ohne dass der Empfänger die App öffnet.
Brauchen Empfänger eine installierte App?
Ja — die kostenlose PushWard-App für iOS rendert die Live-Aktivität. Du musst nichts bauen, signieren oder im App Store einreichen; Empfänger installieren PushWard einmal, und deine Anfragen steuern ihren Sperrbildschirm.
Welche iPhones unterstützen Live-Aktivitäten?
Die PushWard-App erfordert iOS 26 oder neuer. Auf iPhones mit Dynamic Island dockt die Live-Aktivität in der Island an; auf Modellen ohne sie erscheint sie auf dem Sperrbildschirm und im Standby.
Probiere die iOS-Live-Aktivitäten-API aus
Sieh im Playground zu, wie eine Live-Aktivität auf einem simulierten iPhone landet, oder lies die Einstiegsanleitung und sende deine erste in wenigen Minuten mit curl.