De iOS-widgets-API voor alles wat HTTP spreekt
PushWard is een API voor Apples iOS-widgets: declareer een widget één keer en stuur daarna het beginscherm, het toegangsscherm en Stand-by van de iPhone aan met simpele HTTP-verzoeken. Elke update triggert een push-gestuurde WidgetKit-refresh — geen polling, geen WidgetKit-code, geen Xcode, geen App Store-review aan jouw kant.
Wat is een iOS-beginschermwidget?
Widgets zijn Apples oppervlakken voor één oogopslag: kleine, altijd zichtbare tegels op het beginscherm, het toegangsscherm en in Stand-by van de iPhone die informatie tonen zonder een app te openen. Ze worden gebouwd met WidgetKit, Apples on-device framework, en normaal gesproken hoort elk widget bij een app die je zelf zou moeten bouwen, ondertekenen en uitbrengen. De widgets van PushWard zijn anders: de PushWard-app rendert ze, en hun inhoud komt uit jouw API-aanroepen — een sensorwaarde, een healthcheck van een server, een deploy-teller, alles wat als JSON te versturen is.
Hoe de API werkt
Registreer een widget met een POST en werk hem bij met een PATCH — dat is de hele cyclus. Elke update stuurt een lichte push via Apple Push Notification service die WidgetKit opdraagt de tijdlijn van de widget opnieuw te laden, zodat de nieuwe waarde verschijnt zonder dat de widget ooit pollt. Een optionele push-throttle per widget bundelt bronnen die in vlagen versturen.
# 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" } }'Tien widgetsjablonen
Kies de indeling die bij de data past: één waarde, een voortgangsbalk, een statuslampje, een meter, een statistiekenlijst, een trend-sparkline, een afteller, een batterijniveau, een schema of een stroom tussen eindpunten. Elk sjabloon wordt native gerenderd door de PushWard-app, zodat je data zonder enig ontwerpwerk in een verzorgde lay-out landt.
Interactieve widgets die handelen
Widgets kunnen tot drie tikacties dragen: een stille webhook afvuren zonder het beginscherm te verlaten, via een deeplink naar een andere app springen, of een URL openen. Herstart een server, start een Opdracht of bevestig een melding rechtstreeks vanuit de widget — de PushWard-app hoeft nooit open.
Werkt met jouw stack
Voed widgets vanuit de tools die je al draait: een Grafana-alert dat een statuslampje omzet, een Home Assistant-automatisering die een temperatuur bijwerkt, een GitHub Actions-job die een deploy-teller ophoogt, een cronscript dat de leeftijd van een back-up doorgeeft. Alles wat een HTTP-verzoek kan versturen, kan een widget bezitten.
Widgets en live activiteiten samen
Widgets en live activiteiten vullen elkaar aan: een widget is blijvende, omgevingsgerichte status die op het beginscherm staat tot hij wordt verwijderd, terwijl een live activiteit een taak met een begin en een einde is die zich tijdens de uitvoering vastpint op het toegangsscherm en de Dynamic Island. PushWard stuurt beide aan via dezelfde REST API en dezelfde integratiesleutel.
Lees meer over de live-activiteiten-API →
Veelgestelde vragen
Is dit de officiële WidgetKit-API van Apple?
Nee. WidgetKit is Apples on-device framework, en het rechtstreeks gebruiken betekent je eigen iOS-app met een widgetextensie bouwen en uitbrengen. PushWard is een onafhankelijke iOS-widgets-API: de PushWard-app levert de WidgetKit-extensie, en jouw HTTP-verzoeken bepalen wat hij toont.
Hoe snel worden widgets bijgewerkt?
Elke PATCH triggert een lichte push die WidgetKit opdraagt de widget opnieuw te laden, dus updates landen doorgaans binnen seconden. Een push-throttle per widget (1 seconde tot 1 uur) bundelt bronnen die in vlagen versturen, zodat de verversingen binnen het budget blijven dat iOS de extensie toekent.
Werken widgets op het toegangsscherm en in Stand-by?
Ja. PushWard-widgets kun je toevoegen aan het beginscherm, het toegangsscherm en Stand-by van de iPhone. De compacte accessoirevakken van het toegangsscherm renderen een verdichte lay-out, en erop tikken opent de geconfigureerde tikactie.
Moeten ontvangers een app geïnstalleerd hebben?
Ja — de gratis PushWard-app voor iOS (iOS 26 of nieuwer) rendert de widgets en registreert ze in de iOS-widgetkiezer. Er is niets dat jij hoeft te bouwen of in te dienen bij de App Store.
Probeer de iOS-widgets-API
Bouw een widget-payload in de playground en zie hem renderen op een gesimuleerde iPhone, of lees de startgids en registreer binnen een paar minuten je eerste widget met curl.