L'API delle attività in tempo reale di iOS per tutto ciò che parla HTTP

Che cos'è un'attività in tempo reale?

Un'attività in tempo reale è una funzione di iOS che mostra informazioni live, leggibili a colpo d'occhio, sulla schermata di blocco, nella Dynamic Island e in StandBy — senza che il destinatario apra mai un'app. A differenza di una notifica push, che appare una volta e scivola nell'elenco, un'attività in tempo reale resta fissata e continua ad aggiornarsi: una build che avanza tra i suoi passaggi, un timer che scorre, una consegna che si avvicina. PushWard trasforma una singola richiesta HTTP in una di esse.

Le attività in tempo reale di Apple, senza ActivityKit

Le attività in tempo reale sono una funzione iOS di Apple introdotta con iOS 16.1: superfici in tempo reale, leggibili a colpo d'occhio, fissate alla schermata di blocco e alla Dynamic Island. Costruirne una di norma significa pubblicare la propria app iOS con un'estensione widget ActivityKit, richiedere token push-to-start e parlare direttamente con APNs. PushWard sostituisce tutto questo con un'unica REST API: l'app PushWard visualizza la tua attività in tempo reale, e una singola richiesta HTTP la avvia, la aggiorna o la termina.

Come funziona l'API

Crea un'attività, avviala, aggiornala e terminala — tutto tramite la REST API di PushWard con la tua chiave di integrazione. Qualsiasi servizio in grado di inviare una richiesta HTTP può guidare ciò che le persone vedono a colpo d'occhio. Non ci sono certificati APNs né codice client da scrivere; PushWard gestisce la consegna tramite 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 template per ogni tipo di aggiornamento

Scegli tra template di attività in tempo reale pensati per compiti diversi — una barra di avanzamento generica, un conto alla rovescia, una sequenza di passaggi, un avviso, un indicatore, una sparkline temporale, una board di riquadri o un registro eventi live. Ognuno ha un layout ottimizzato per la schermata di blocco e la Dynamic Island.

Sfoglia i template →

Funziona con il tuo stack

Invia attività in tempo reale direttamente dagli strumenti che già usi. Bridge pronti all'uso e un relay webhook ospitato coprono gli avvisi di Grafana, le automazioni di Home Assistant, GitHub Actions, i download di SABnzbd, le stampe Bambu Lab, le sync di ArgoCD e qualsiasi altra cosa in grado di inviare JSON.

Vedi tutte le integrazioni →

Domande frequenti

È l'API ufficiale di Apple per le attività in tempo reale?

No. Il framework ufficiale di Apple è ActivityKit, che richiede di costruire e pubblicare la propria app iOS. PushWard è un'API indipendente per le attività in tempo reale di iOS: consegna i tuoi aggiornamenti tramite Apple Push Notification service all'app PushWard, che li visualizza sulla schermata di blocco e nella Dynamic Island.

Posso avviare un'attività in tempo reale da un server?

Sì — è proprio questo il punto. Qualsiasi server, script o automazione in grado di inviare una richiesta HTTP può creare, avviare, aggiornare e terminare un'attività in tempo reale. PushWard gestisce per te il flusso push-to-start di Apple, così l'attività appare senza che il destinatario apra l'app.

I destinatari devono avere un'app installata?

Sì — l'app iOS gratuita di PushWard visualizza l'attività in tempo reale. Non c'è nulla da costruire, firmare o inviare all'App Store; i destinatari installano PushWard una volta e le tue richieste guidano la loro schermata di blocco.

Quali iPhone supportano le attività in tempo reale?

L'app PushWard richiede iOS 26 o versioni successive. Sugli iPhone con la Dynamic Island l'attività in tempo reale si aggancia all'isola; sui modelli che ne sono privi appare sulla schermata di blocco e in StandBy.

Prova l'API delle attività in tempo reale di iOS

Guarda un'attività in tempo reale arrivare su un iPhone simulato nel playground, oppure leggi la guida introduttiva e invia la tua prima con curl in pochi minuti.