La API de actividades en directo de iOS para todo lo que hable HTTP
PushWard es una API para las actividades en directo de Apple: envía una sola petición HTTP y aparece en vivo en la pantalla de bloqueo y la Dynamic Island del iPhone, actualizándose en tiempo real y retirándose sola cuando la tarea termina. Sin código de ActivityKit, sin Xcode y sin revisión del App Store por tu parte.
¿Qué es una actividad en directo?
Una actividad en directo es una función de iOS que muestra información en vivo y de un vistazo en la pantalla de bloqueo, en la Dynamic Island y en el modo En reposo — sin que el destinatario abra nunca una app. A diferencia de una notificación push, que aparece una vez y se pierde en la lista, una actividad en directo permanece fijada y se actualiza en tiempo real: un build avanzando por sus pasos, un temporizador en cuenta atrás, un pedido acercándose. PushWard convierte una sola petición HTTP en una de ellas.
Las actividades en directo de Apple, sin ActivityKit
Las actividades en directo son una función de iOS de Apple introducida en iOS 16.1: superficies en tiempo real, visibles de un vistazo, fijadas a la pantalla de bloqueo y la Dynamic Island. Crear una normalmente implica publicar tu propia app de iOS con una extensión de widget de ActivityKit, solicitar tokens push-to-start y hablar tú mismo con APNs. PushWard sustituye todo eso por una única REST API: la app de PushWard renderiza tu actividad en directo, y una sola petición HTTP la inicia, la actualiza o la termina.
Cómo funciona la API
Crea una actividad, iníciala, actualízala y termínala — todo a través de la REST API de PushWard con tu clave de integración. Cualquier servicio capaz de enviar una petición HTTP puede controlar lo que la gente ve de un vistazo. No hay certificados de APNs ni código de cliente que escribir; PushWard se encarga de la entrega a través de 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"
} }'Una plantilla para cada tipo de actualización
Elige entre plantillas de actividades en directo pensadas para distintos trabajos — una barra de progreso genérica, una cuenta atrás, una secuencia de pasos, una alerta, un indicador, una sparkline de línea de tiempo, un tablero de fichas o un registro de eventos en vivo. Cada una tiene un diseño ajustado a la pantalla de bloqueo y la Dynamic Island.
Funciona con tu stack
Envía actividades en directo desde las propias herramientas que ya usas. Bridges listos para usar y un relay de webhooks alojado cubren alertas de Grafana, automatizaciones de Home Assistant, GitHub Actions, descargas de SABnzbd, impresiones de Bambu Lab, sincronizaciones de ArgoCD y cualquier otra cosa capaz de enviar JSON.
Preguntas frecuentes
¿Es esta la API oficial de actividades en directo de Apple?
No. El framework oficial de Apple es ActivityKit, que exige crear y publicar tu propia app de iOS. PushWard es una API de actividades en directo de iOS independiente: entrega tus actualizaciones a través de Apple Push Notification service a la app de PushWard, que las renderiza en la pantalla de bloqueo y en la Dynamic Island.
¿Puedo iniciar una actividad en directo desde un servidor?
Sí — de eso se trata. Cualquier servidor, script o automatización capaz de enviar una petición HTTP puede crear, iniciar, actualizar y terminar una actividad en directo. PushWard gestiona por ti el flujo push-to-start de Apple, de modo que la actividad aparece sin que el destinatario abra la app.
¿Los destinatarios necesitan tener una app instalada?
Sí — la app gratuita de PushWard para iOS renderiza la actividad en directo. No tienes que crear, firmar ni enviar nada al App Store; los destinatarios instalan PushWard una vez y tus peticiones controlan su pantalla de bloqueo.
¿Qué iPhone admiten las actividades en directo?
La app de PushWard requiere iOS 26 o posterior. En los iPhone con Dynamic Island, la actividad en directo se acopla a la isla; en los modelos sin ella, aparece en la pantalla de bloqueo y en el modo En reposo.
Prueba la API de actividades en directo de iOS
Mira cómo una actividad en directo aterriza en un iPhone simulado en el playground, o lee la guía de inicio y envía la primera con curl en unos minutos.