API-ul de Activități live pe iOS pentru orice vorbește HTTP

Ce este o Activitate live?

O Activitate live este o funcție iOS care afișează informații live, vizibile dintr-o privire, pe ecranul de blocare, în Dynamic Island și în modul În repaus — fără ca destinatarul să deschidă vreodată o aplicație. Spre deosebire de o notificare push, care apare o dată și se pierde în listă, o Activitate live rămâne fixată și se actualizează în timp real: un build care își parcurge pașii, un cronometru care numără invers, o livrare care se apropie. PushWard transformă o singură cerere HTTP exact în asta.

Activitățile live de la Apple, fără ActivityKit

Activitățile live sunt o funcție iOS de la Apple introdusă în iOS 16.1: suprafețe în timp real, vizibile dintr-o privire, fixate pe ecranul de blocare și în Dynamic Island. A construi una înseamnă, în mod normal, să publici propria aplicație iOS cu o extensie de widget ActivityKit, să soliciți tokenuri push-to-start și să vorbești tu însuți cu APNs. PushWard înlocuiește toate acestea cu un singur REST API: aplicația PushWard redă Activitatea ta live, iar o singură cerere HTTP o pornește, o actualizează sau o încheie.

Cum funcționează API-ul

Creezi o activitate, o pornești, o actualizezi și o închei — totul prin REST API-ul PushWard cu cheia ta de integrare. Orice serviciu care poate trimite o cerere HTTP poate controla ce văd oamenii dintr-o privire. Nu există certificate APNs și niciun cod de client de scris; PushWard se ocupă de livrare prin 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 șablon pentru fiecare tip de actualizare

Alege dintre șabloane de Activități live gândite pentru sarcini diferite — o bară de progres generică, o numărătoare inversă, o secvență de pași, o alertă, un indicator, un sparkline pe axă de timp, un panou de plăci sau un jurnal de evenimente live. Fiecare are un layout adaptat pentru ecranul de blocare și Dynamic Island.

Răsfoiește șabloanele →

Funcționează cu stack-ul tău

Trimite Activități live direct din uneltele pe care le rulezi deja. Punți gata făcute și un relay de webhookuri găzduit acoperă alertele Grafana, automatizările Home Assistant, GitHub Actions, descărcările SABnzbd, printurile Bambu Lab, sincronizările ArgoCD și orice altceva care poate trimite JSON.

Vezi toate integrările →

Întrebări frecvente

Este acesta API-ul oficial de Activități live de la Apple?

Nu. Framework-ul oficial al Apple este ActivityKit, care cere să construiești și să publici propria aplicație iOS. PushWard este un API independent de Activități live pe iOS: livrează actualizările tale prin Apple Push Notification service către aplicația PushWard, care le redă pe ecranul de blocare și în Dynamic Island.

Pot porni o Activitate live de pe un server?

Da — exact asta e ideea. Orice server, script sau automatizare care poate trimite o cerere HTTP poate crea, porni, actualiza și încheia o Activitate live. PushWard gestionează pentru tine fluxul push-to-start al Apple, astfel încât activitatea apare fără ca destinatarul să deschidă aplicația.

Destinatarii au nevoie de o aplicație instalată?

Da — aplicația iOS gratuită PushWard redă Activitatea live. Nu ai nimic de construit, semnat sau trimis în App Store; destinatarii instalează PushWard o singură dată, iar cererile tale le controlează ecranul de blocare.

Ce iPhone-uri acceptă Activitățile live?

Aplicația PushWard necesită iOS 26 sau o versiune mai nouă. Pe iPhone-urile cu Dynamic Island, Activitatea live se andochează în insulă; pe modelele fără ea, apare pe ecranul de blocare și în modul În repaus.

Încearcă API-ul de Activități live pe iOS

Urmărește în playground cum o Activitate live ajunge pe un iPhone simulat sau citește ghidul de început și trimite-o pe prima cu curl în câteva minute.