L'API d'activités en direct iOS pour tout ce qui parle HTTP

Qu'est-ce qu'une activité en direct ?

Une activité en direct est une fonctionnalité iOS qui affiche des informations en direct, lisibles d'un coup d'œil, sur l'écran verrouillé, dans la Dynamic Island et en mode En veille — sans que le destinataire n'ouvre jamais d'app. Contrairement à une notification push qui apparaît une fois puis se perd dans la liste, une activité en direct reste épinglée et se met à jour en temps réel : un build qui avance étape par étape, un minuteur qui décompte, une livraison qui approche. PushWard transforme une seule requête HTTP en l'une d'elles.

Les activités en direct d'Apple, sans ActivityKit

Les activités en direct sont une fonctionnalité iOS d'Apple introduite avec iOS 16.1 : des surfaces en temps réel, lisibles d'un coup d'œil, épinglées à l'écran verrouillé et à la Dynamic Island. En créer une signifie normalement publier votre propre app iOS avec une extension de widget ActivityKit, demander des jetons push-to-start et dialoguer vous-même avec APNs. PushWard remplace tout cela par une seule API REST : l'app PushWard affiche votre activité en direct, et une seule requête HTTP la démarre, la met à jour ou la termine.

Comment fonctionne l'API

Créez une activité, démarrez-la, mettez-la à jour et terminez-la — le tout via l'API REST de PushWard avec votre clé d'intégration. Tout service capable d'envoyer une requête HTTP peut piloter ce que les gens voient d'un coup d'œil. Aucun certificat APNs, aucun code client à écrire ; PushWard gère la livraison 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"
  } }'

Un modèle pour chaque type de mise à jour

Choisissez parmi des modèles d'activité en direct conçus pour différents usages — une barre de progression générique, un compte à rebours, une séquence d'étapes, une alerte, une jauge, une sparkline chronologique, un tableau de tuiles ou un journal d'événements en direct. Chacun a une mise en page pensée pour l'écran verrouillé et la Dynamic Island.

Parcourir les modèles →

Compatible avec votre stack

Envoyez des activités en direct directement depuis les outils que vous utilisez déjà. Des ponts prêts à l'emploi et un relay de webhooks hébergé couvrent les alertes Grafana, les automatisations Home Assistant, GitHub Actions, les téléchargements SABnzbd, les impressions Bambu Lab, les synchronisations ArgoCD et tout ce qui peut envoyer du JSON.

Voir toutes les intégrations →

Questions fréquentes

Est-ce l'API officielle d'Apple pour les activités en direct ?

Non. Le framework officiel d'Apple est ActivityKit, qui impose de créer et publier votre propre app iOS. PushWard est une API d'activités en direct iOS indépendante : elle délivre vos mises à jour via Apple Push Notification service à l'app PushWard, qui les affiche sur l'écran verrouillé et dans la Dynamic Island.

Puis-je démarrer une activité en direct depuis un serveur ?

Oui — c'est tout l'intérêt. N'importe quel serveur, script ou automatisation capable d'envoyer une requête HTTP peut créer, démarrer, mettre à jour et terminer une activité en direct. PushWard gère pour vous le flux push-to-start d'Apple, de sorte que l'activité apparaît sans que le destinataire n'ouvre l'app.

Les destinataires doivent-ils installer une app ?

Oui — l'app iOS gratuite PushWard affiche l'activité en direct. Vous n'avez rien à créer, signer ou soumettre à l'App Store ; les destinataires installent PushWard une fois et vos requêtes pilotent leur écran verrouillé.

Quels iPhone prennent en charge les activités en direct ?

L'app PushWard nécessite iOS 26 ou une version ultérieure. Sur les iPhone dotés de la Dynamic Island, l'activité en direct s'ancre dans l'île ; sur les modèles qui en sont dépourvus, elle apparaît sur l'écran verrouillé et en mode En veille.

Essayez l'API d'activités en direct iOS

Regardez une activité en direct arriver sur un iPhone simulé dans le playground, ou lisez le guide de démarrage et envoyez la vôtre avec curl en quelques minutes.