API wydarzeń na żywo na iOS dla wszystkiego, co mówi po HTTP

Czym jest wydarzenie na żywo?

Wydarzenie na żywo to funkcja iOS, która pokazuje bieżące, czytelne na pierwszy rzut oka informacje na ekranie blokady, w Dynamic Island i w trybie czuwania — bez otwierania jakiejkolwiek aplikacji przez odbiorcę. W przeciwieństwie do powiadomienia push, które pojawia się raz i ginie na liście, wydarzenie na żywo pozostaje przypięte i aktualizuje się w czasie rzeczywistym: build przechodzący przez kolejne kroki, odliczający timer, zbliżająca się dostawa. PushWard zamienia jedno żądanie HTTP właśnie w to.

Wydarzenia na żywo Apple, bez ActivityKit

Wydarzenia na żywo to funkcja iOS od Apple wprowadzona w iOS 16.1: czytelne na pierwszy rzut oka, aktualizowane w czasie rzeczywistym powierzchnie przypięte do ekranu blokady i Dynamic Island. Zbudowanie własnego zwykle oznacza wydanie swojej aplikacji iOS z rozszerzeniem widżetu ActivityKit, pozyskiwanie tokenów push-to-start i samodzielną komunikację z APNs. PushWard zastępuje to wszystko jednym REST API: aplikacja PushWard renderuje Twoje wydarzenie na żywo, a pojedyncze żądanie HTTP je uruchamia, aktualizuje lub kończy.

Jak działa API

Utwórz aktywność, uruchom ją, aktualizuj i zakończ — wszystko przez REST API PushWard z Twoim kluczem integracji. Każda usługa, która potrafi wysłać żądanie HTTP, może sterować tym, co ludzie widzą na pierwszy rzut oka. Nie ma certyfikatów APNs ani kodu klienta do napisania; PushWard zajmuje się dostarczaniem przez 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"
  } }'

Szablon na każdy rodzaj aktualizacji

Wybieraj spośród szablonów wydarzeń na żywo stworzonych do różnych zadań — ogólny pasek postępu, odliczanie, sekwencja kroków, alert, wskaźnik, sparkline osi czasu, tablica kafelków lub dziennik zdarzeń na żywo. Każdy ma układ dopracowany z myślą o ekranie blokady i Dynamic Island.

Przeglądaj szablony →

Działa z Twoim stackiem

Wysyłaj wydarzenia na żywo prosto z narzędzi, których już używasz. Gotowe mostki i hostowany relay webhooków obsługują alerty Grafana, automatyzacje Home Assistant, GitHub Actions, pobierania SABnzbd, wydruki Bambu Lab, synchronizacje ArgoCD i wszystko inne, co potrafi wysłać JSON.

Zobacz wszystkie integracje →

Najczęściej zadawane pytania

Czy to oficjalne API wydarzeń na żywo od Apple?

Nie. Oficjalnym frameworkiem Apple jest ActivityKit, który wymaga zbudowania i wydania własnej aplikacji iOS. PushWard to niezależne API wydarzeń na żywo dla iOS: dostarcza Twoje aktualizacje przez Apple Push Notification service do aplikacji PushWard, która renderuje je na ekranie blokady i w Dynamic Island.

Czy mogę uruchomić wydarzenie na żywo z serwera?

Tak — właśnie o to chodzi. Każdy serwer, skrypt czy automatyzacja, które potrafią wysłać żądanie HTTP, mogą utworzyć, uruchomić, zaktualizować i zakończyć wydarzenie na żywo. PushWard obsługuje za Ciebie przepływ push-to-start Apple, więc wydarzenie pojawia się bez otwierania aplikacji przez odbiorcę.

Czy odbiorcy muszą mieć zainstalowaną aplikację?

Tak — bezpłatna aplikacja PushWard na iOS renderuje wydarzenie na żywo. Nie musisz niczego budować, podpisywać ani zgłaszać do App Store; odbiorcy instalują PushWard raz, a Twoje żądania sterują ich ekranem blokady.

Które iPhone'y obsługują wydarzenia na żywo?

Aplikacja PushWard wymaga iOS 26 lub nowszego. Na iPhone'ach z Dynamic Island wydarzenie na żywo dokuje w wyspie; na modelach bez niej pojawia się na ekranie blokady i w trybie czuwania.

Wypróbuj API wydarzeń na żywo dla iOS

Zobacz w playgroundzie, jak wydarzenie na żywo ląduje na symulowanym iPhonie, albo przeczytaj przewodnik startowy i wyślij pierwsze z curl w kilka minut.