L'API de widgets iOS pour tout ce qui parle HTTP

Qu'est-ce qu'un widget d'écran d'accueil iOS ?

Les widgets sont les surfaces d'un coup d'œil d'Apple : de petites tuiles toujours visibles sur l'écran d'accueil, l'écran verrouillé et le mode En veille de l'iPhone, qui affichent des informations sans ouvrir d'app. Ils sont construits avec WidgetKit, le framework embarqué d'Apple, et chacun appartient normalement à une app que vous devriez créer, signer et publier vous-même. Les widgets de PushWard sont différents : l'app PushWard les affiche, et leur contenu vient de vos appels d'API — un relevé de capteur, un contrôle de santé de serveur, un compteur de déploiements, tout ce qui peut être envoyé en JSON.

Comment fonctionne l'API

Enregistrez un widget avec un POST, puis mettez-le à jour avec un PATCH — c'est toute la boucle. Chaque mise à jour envoie un push léger via Apple Push Notification service qui demande à WidgetKit de recharger la timeline du widget : la nouvelle valeur apparaît sans que le widget ne fasse jamais de polling. Un limiteur de push optionnel par widget regroupe les sources en rafales.

# 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" } }'

Dix modèles de widget

Choisissez la disposition qui convient aux données : une valeur unique, une barre de progression, un voyant d'état, une jauge, une liste de statistiques, une sparkline de tendance, un compte à rebours, un niveau de batterie, un planning ou un flux entre points. Chaque modèle est affiché nativement par l'app PushWard, vos données atterrissent donc dans une mise en page soignée sans aucun travail de design.

Parcourir les modèles de widget →

Des widgets interactifs qui agissent

Les widgets peuvent porter jusqu'à trois actions au toucher : déclencher un webhook silencieux sans quitter l'écran d'accueil, ouvrir une autre app via un lien profond, ou ouvrir une URL. Redémarrez un serveur, lancez un raccourci ou acquittez une alerte directement depuis le widget — l'app PushWard n'a jamais besoin de s'ouvrir.

Compatible avec votre stack

Alimentez des widgets depuis les outils que vous utilisez déjà : une alerte Grafana qui bascule un voyant d'état, une automatisation Home Assistant qui met à jour une température, un job GitHub Actions qui incrémente un compteur de déploiements, un script cron qui publie l'âge d'une sauvegarde. Tout ce qui peut envoyer une requête HTTP peut posséder un widget.

Voir toutes les intégrations →

Widgets et activités en direct, ensemble

Les widgets et les activités en direct sont complémentaires : un widget est un statut persistant et ambiant qui reste sur l'écran d'accueil jusqu'à ce qu'on le retire, tandis qu'une activité en direct est une tâche avec un début et une fin, qui s'épingle à l'écran verrouillé et à la Dynamic Island pendant qu'elle s'exécute. PushWard pilote les deux via la même API REST et la même clé d'intégration.

Découvrir l'API d'activités en direct →

Questions fréquentes

Est-ce l'API WidgetKit officielle d'Apple ?

Non. WidgetKit est le framework embarqué d'Apple, et l'utiliser directement signifie créer et publier votre propre app iOS avec une extension de widget. PushWard est une API de widgets iOS indépendante : l'app PushWard embarque l'extension WidgetKit, et vos requêtes HTTP décident de ce qu'elle affiche.

À quelle vitesse les widgets se mettent-ils à jour ?

Chaque PATCH déclenche un push léger qui demande à WidgetKit de recharger le widget : les mises à jour arrivent donc généralement en quelques secondes. Un limiteur de push par widget (de 1 seconde à 1 heure) regroupe les sources en rafales, en maintenant les rafraîchissements dans le budget qu'iOS accorde à l'extension.

Les widgets fonctionnent-ils sur l'écran verrouillé et en mode En veille ?

Oui. Les widgets PushWard peuvent être ajoutés à l'écran d'accueil, à l'écran verrouillé et au mode En veille de l'iPhone. Les emplacements compacts d'accessoires de l'écran verrouillé affichent une mise en page condensée, et toucher l'un d'eux ouvre l'action au toucher configurée.

Les destinataires doivent-ils installer une app ?

Oui — l'app iOS gratuite PushWard (iOS 26 ou version ultérieure) affiche les widgets et les enregistre dans le sélecteur de widgets d'iOS. Vous n'avez rien à créer ni à soumettre à l'App Store.

Essayez l'API de widgets iOS

Construisez une charge utile de widget dans le playground et regardez-la s'afficher sur un iPhone simulé, ou lisez le guide de démarrage et enregistrez votre premier widget avec curl en quelques minutes.