De iOS-API voor live activiteiten, voor alles wat HTTP spreekt

Wat is een live activiteit?

Een live activiteit is een iOS-functie die live, in één oogopslag leesbare informatie toont op het toegangsscherm, in de Dynamic Island en in Stand-by — zonder dat de ontvanger ooit een app opent. Anders dan een pushmelding, die één keer verschijnt en in de lijst verdwijnt, blijft een live activiteit vastgezet en wordt hij realtime bijgewerkt: een build die zijn stappen doorloopt, een timer die aftelt, een bezorging die dichterbij komt. PushWard maakt van één HTTP-verzoek precies dat.

Apples live activiteiten, zonder ActivityKit

Live activiteiten zijn een iOS-functie van Apple, geïntroduceerd in iOS 16.1: realtime oppervlakken die je in één oogopslag leest, vastgezet op het toegangsscherm en de Dynamic Island. Er zelf een bouwen betekent normaal gesproken je eigen iOS-app uitbrengen met een ActivityKit-widgetextensie, push-to-start-tokens aanvragen en zelf met APNs praten. PushWard vervangt dat alles door één REST API: de PushWard-app rendert je live activiteit, en één HTTP-verzoek start, update of beëindigt hem.

Zo werkt de API

Maak een activiteit aan, start, update en beëindig hem — allemaal via de REST API van PushWard met je integratiesleutel. Elke service die een HTTP-verzoek kan versturen, bepaalt wat mensen in één oogopslag zien. Er zijn geen APNs-certificaten en geen clientcode om te schrijven; PushWard verzorgt de bezorging via 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"
  } }'

Een sjabloon voor elk soort update

Kies uit sjablonen voor live activiteiten, gemaakt voor uiteenlopende taken — een generieke voortgangsbalk, een countdown, een stappenreeks, een alert, een meter, een tijdlijn-sparkline, een bord met tegels of een live gebeurtenissenlog. Elk heeft een lay-out afgestemd op het toegangsscherm en de Dynamic Island.

Bekijk de sjablonen →

Werkt met jouw stack

Verstuur live activiteiten rechtstreeks vanuit de tools die je al draait. Kant-en-klare bridges en een gehoste webhook-relay dekken Grafana-alerts, Home Assistant-automatiseringen, GitHub Actions, SABnzbd-downloads, Bambu Lab-prints, ArgoCD-syncs en alles wat verder JSON kan versturen.

Bekijk alle integraties →

Veelgestelde vragen

Is dit de officiële live-activiteiten-API van Apple?

Nee. Het officiële framework van Apple is ActivityKit, dat vereist dat je je eigen iOS-app bouwt en uitbrengt. PushWard is een onafhankelijke iOS-API voor live activiteiten: hij bezorgt je updates via Apple Push Notification service aan de PushWard-app, die ze rendert op het toegangsscherm en in de Dynamic Island.

Kan ik een live activiteit vanaf een server starten?

Ja — dat is precies het punt. Elke server, elk script en elke automatisering die een HTTP-verzoek kan versturen, kan een live activiteit aanmaken, starten, bijwerken en beëindigen. PushWard handelt Apples push-to-start-flow voor je af, zodat de activiteit verschijnt zonder dat de ontvanger de app opent.

Moeten ontvangers een app geïnstalleerd hebben?

Ja — de gratis PushWard-app voor iOS rendert de live activiteit. Er is niets dat jij hoeft te bouwen, ondertekenen of indienen bij de App Store; ontvangers installeren PushWard één keer en jouw verzoeken sturen hun toegangsscherm aan.

Welke iPhones ondersteunen live activiteiten?

De PushWard-app vereist iOS 26 of nieuwer. Op iPhones met de Dynamic Island nestelt de live activiteit zich in de island; op modellen zonder verschijnt hij op het toegangsscherm en in Stand-by.

Probeer de iOS-API voor live activiteiten

Zie in de playground een live activiteit op een gesimuleerde iPhone landen, of lees de startgids en verstuur er binnen een paar minuten zelf een met curl.