La API de widgets de iOS para todo lo que hable HTTP

¿Qué es un widget de la pantalla de inicio de iOS?

Los widgets son las superficies de un vistazo de Apple: pequeños mosaicos siempre visibles en la pantalla de inicio, la pantalla de bloqueo y el modo En reposo del iPhone que muestran información sin abrir una app. Se construyen con WidgetKit, el framework en el dispositivo de Apple, y normalmente cada uno pertenece a una app que tendrías que crear, firmar y publicar tú mismo. Los widgets de PushWard son distintos: la app de PushWard los renderiza, y su contenido proviene de tus llamadas a la API — una lectura de sensor, un chequeo de salud de un servidor, un contador de despliegues, cualquier cosa que se pueda enviar como JSON.

Cómo funciona la API

Registra un widget con un POST y actualízalo con un PATCH — ese es todo el ciclo. Cada actualización envía un push ligero a través de Apple Push Notification service que indica a WidgetKit que recargue la línea de tiempo del widget, de modo que el nuevo valor aparece sin que el widget haga polling jamás. Un límite de push opcional por widget agrupa las fuentes con ráfagas.

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

Diez plantillas de widget

Elige el diseño que encaje con los datos: un valor único, una barra de progreso, una luz de estado, un indicador, una lista de estadísticas, una sparkline de tendencia, una cuenta atrás, un nivel de batería, un horario o un flujo entre extremos. Cada plantilla la renderiza de forma nativa la app de PushWard, así que tus datos aterrizan en un diseño pulido sin ningún trabajo de diseño.

Explora las plantillas de widget →

Widgets interactivos que actúan

Los widgets pueden llevar hasta tres acciones de toque: disparar un webhook silencioso sin salir de la pantalla de inicio, abrir otra app mediante un enlace profundo o abrir una URL. Reinicia un servidor, lanza un atajo o confirma una alerta directamente desde el widget — la app de PushWard nunca tiene que abrirse.

Funciona con tu stack

Alimenta widgets desde las herramientas que ya usas: una alerta de Grafana que cambia una luz de estado, una automatización de Home Assistant que actualiza una temperatura, un trabajo de GitHub Actions que incrementa un contador de despliegues, un script de cron que publica la antigüedad de una copia de seguridad. Si puede enviar una petición HTTP, puede tener su propio widget.

Ver todas las integraciones →

Widgets y actividades en directo, juntos

Los widgets y las actividades en directo se complementan: un widget es estado persistente y ambiental que permanece en la pantalla de inicio hasta que se retira, mientras que una actividad en directo es una tarea con principio y fin que se fija a la pantalla de bloqueo y la Dynamic Island mientras dura. PushWard controla ambos a través de la misma REST API y la misma clave de integración.

Conoce la API de actividades en directo →

Preguntas frecuentes

¿Es esta la API oficial WidgetKit de Apple?

No. WidgetKit es el framework en el dispositivo de Apple, y usarlo directamente implica crear y publicar tu propia app de iOS con una extensión de widget. PushWard es una API de widgets de iOS independiente: la app de PushWard incluye la extensión de WidgetKit, y tus peticiones HTTP deciden lo que muestra.

¿Con qué rapidez se actualizan los widgets?

Cada PATCH dispara un push ligero que indica a WidgetKit que recargue el widget, así que las actualizaciones suelen llegar en cuestión de segundos. Un límite de push por widget (de 1 segundo a 1 hora) agrupa las fuentes con ráfagas, manteniendo los refrescos dentro del presupuesto que iOS concede a la extensión.

¿Los widgets funcionan en la pantalla de bloqueo y en el modo En reposo?

Sí. Los widgets de PushWard pueden añadirse a la pantalla de inicio, la pantalla de bloqueo y el modo En reposo del iPhone. Los espacios compactos de accesorios de la pantalla de bloqueo muestran un diseño condensado, y al tocar uno se abre su acción de toque configurada.

¿Los destinatarios necesitan tener una app instalada?

Sí — la app gratuita de PushWard para iOS (iOS 26 o posterior) renderiza los widgets y los registra en el selector de widgets de iOS. No tienes que crear ni enviar nada al App Store.

Prueba la API de widgets de iOS

Construye un payload de widget en el playground y míralo renderizarse en un iPhone simulado, o lee la guía de inicio y registra tu primer widget con curl en unos minutos.