Die iOS-Widgets-API für alles, was HTTP spricht

Was ist ein iOS-Home-Bildschirm-Widget?

Widgets sind Apples Flächen für den schnellen Blick: kleine, ständig sichtbare Kacheln auf dem iPhone-Home-Bildschirm, dem Sperrbildschirm und im Standby, die Informationen zeigen, ohne dass eine App geöffnet wird. Sie werden mit WidgetKit gebaut, Apples On-Device-Framework, und normalerweise gehört jedes zu einer App, die du selbst bauen, signieren und ausliefern müsstest. Die Widgets von PushWard sind anders: Die PushWard-App rendert sie, und ihr Inhalt kommt aus deinen API-Aufrufen — ein Sensorwert, ein Server-Healthcheck, ein Deploy-Zähler, alles, was sich als JSON senden lässt.

So funktioniert die API

Registriere ein Widget mit einem POST und aktualisiere es mit einem PATCH — das ist der ganze Ablauf. Jedes Update schickt einen schlanken Push über den Apple Push Notification service, der WidgetKit anweist, die Timeline des Widgets neu zu laden — der neue Wert erscheint, ohne dass das Widget je pollt. Eine optionale Push-Drossel pro Widget fasst stoßweise sendende Quellen zusammen.

# 1. Register a widget
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "cpu-load", "name": "CPU Load", "content": {
    "template": "progress", "value": 0.42,
    "label": "load avg", "icon": "cpu", "accent_color": "cyan"
  } }'

# 2. Update it - WidgetKit refreshes the widget
curl -X PATCH https://api.pushward.app/widgets/cpu-load \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "content": { "value": 0.78, "accent_color": "orange" } }'

Zehn Widget-Vorlagen

Wähle das Layout, das zu den Daten passt: ein einzelner Wert, ein Fortschrittsbalken, eine Statusleuchte, eine Anzeige, eine Statistikliste, eine Trend-Sparkline, ein Countdown, ein Batteriestand, ein Zeitplan oder ein Fluss zwischen Endpunkten. Jede Vorlage wird nativ von der PushWard-App gerendert, sodass deine Daten ohne Designarbeit in einem ausgefeilten Layout landen.

Widget-Vorlagen ansehen →

Interaktive Widgets, die handeln

Widgets können bis zu drei Tippaktionen tragen: einen stillen Webhook auslösen, ohne den Home-Bildschirm zu verlassen, per Deep Link in eine andere App springen oder eine URL öffnen. Starte einen Server neu, löse einen Kurzbefehl aus oder bestätige einen Alarm direkt vom Widget aus — die PushWard-App muss sich dafür nie öffnen.

Funktioniert mit deinem Stack

Speise Widgets aus den Tools, die du ohnehin betreibst: ein Grafana-Alarm schaltet eine Statusleuchte um, eine Home-Assistant-Automatisierung aktualisiert eine Temperatur, ein GitHub-Actions-Job erhöht einen Deploy-Zähler, ein Cron-Skript meldet das Alter des letzten Backups. Alles, was eine HTTP-Anfrage senden kann, kann ein Widget besitzen.

Alle Integrationen ansehen →

Widgets und Live-Aktivitäten zusammen

Widgets und Live-Aktivitäten ergänzen sich: Ein Widget ist beständiger, stiller Status, der auf dem Home-Bildschirm bleibt, bis er entfernt wird, während eine Live-Aktivität eine Aufgabe mit Anfang und Ende ist, die sich während ihrer Laufzeit an den Sperrbildschirm und die Dynamic Island heftet. PushWard steuert beide über dieselbe REST API und denselben Integrationsschlüssel.

Mehr über die Live-Aktivitäten-API →

Häufig gestellte Fragen

Ist das die offizielle WidgetKit-API von Apple?

Nein. WidgetKit ist Apples On-Device-Framework, und es direkt zu nutzen heißt, eine eigene iOS-App mit einer Widget-Extension zu bauen und auszuliefern. PushWard ist eine unabhängige iOS-Widgets-API: Die PushWard-App liefert die WidgetKit-Extension, und deine HTTP-Anfragen bestimmen, was sie zeigt.

Wie schnell aktualisieren sich Widgets?

Jedes PATCH löst einen schlanken Push aus, der WidgetKit anweist, das Widget neu zu laden — Updates kommen daher typischerweise innerhalb von Sekunden an. Eine Push-Drossel pro Widget (1 Sekunde bis 1 Stunde) fasst stoßweise sendende Quellen zusammen und hält die Aktualisierungen innerhalb des Budgets, das iOS der Extension gewährt.

Funktionieren Widgets auf dem Sperrbildschirm und im Standby?

Ja. PushWard-Widgets lassen sich zum iPhone-Home-Bildschirm, zum Sperrbildschirm und zu Standby hinzufügen. Die kompakten Accessory-Plätze des Sperrbildschirms rendern ein verdichtetes Layout, und ein Tipp darauf öffnet die konfigurierte Tippaktion.

Brauchen Empfänger eine installierte App?

Ja — die kostenlose PushWard-App für iOS (iOS 26 oder neuer) rendert die Widgets und registriert sie in der iOS-Widget-Auswahl. Du musst nichts bauen oder im App Store einreichen.

Probiere die iOS-Widgets-API aus

Baue im Playground ein Widget-Payload und sieh zu, wie es auf einem simulierten iPhone gerendert wird, oder lies die Einstiegsanleitung und registriere dein erstes Widget in wenigen Minuten mit curl.