API widżetów na iOS dla wszystkiego, co mówi po HTTP

PushWard to API dla widżetów iOS od Apple: zadeklaruj widżet raz, a potem steruj ekranem głównym, ekranem blokady i trybem czuwania iPhone'a zwykłymi żądaniami HTTP. Każda aktualizacja wyzwala sterowane pushem odświeżenie WidgetKit — bez odpytywania, bez kodu WidgetKit, bez Xcode, bez recenzji App Store po Twojej stronie.

Czym jest widżet ekranu głównego iOS?

Widżety to powierzchnie Apple czytelne na pierwszy rzut oka: małe, zawsze widoczne kafelki na ekranie głównym, ekranie blokady i w trybie czuwania iPhone'a, które pokazują informacje bez otwierania aplikacji. Buduje się je we frameworku WidgetKit działającym na urządzeniu, a każdy zwykle należy do aplikacji, którą trzeba by samemu zbudować, podpisać i wydać. Widżety PushWard są inne: renderuje je aplikacja PushWard, a ich treść pochodzi z Twoich wywołań API — odczyt czujnika, stan zdrowia serwera, licznik wdrożeń, cokolwiek, co da się wysłać jako JSON.

Jak działa API

Zarejestruj widżet żądaniem POST, potem aktualizuj go żądaniem PATCH — to cała pętla. Każda aktualizacja wysyła lekki push przez Apple Push Notification service, który każe WidgetKit przeładować oś czasu widżetu, więc nowa wartość pojawia się bez żadnego odpytywania. Opcjonalny ogranicznik pushy per widżet scala źródła wysyłające seriami.

Zarejestruj i aktualizuj widżet przez HTTP

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

Dziesięć szablonów widżetów

Wybierz układ pasujący do danych: pojedyncza wartość, pasek postępu, lampka stanu, wskaźnik, lista statystyk, wykres trendu, odliczanie, poziom baterii, harmonogram albo przepływ między punktami. Każdy szablon jest renderowany natywnie przez aplikację PushWard, więc Twoje dane trafiają do dopracowanego układu bez żadnej pracy projektowej.

Przeglądaj szablony widżetów →

Interaktywne widżety, które działają

Widżety mogą nieść do trzech akcji dotknięcia: wywołać cichy webhook bez opuszczania ekranu głównego, przenieść głębokim linkiem do innej aplikacji albo otworzyć URL. Zrestartuj serwer, uruchom Skrót lub potwierdź alert wprost z widżetu — aplikacja PushWard nigdy nie musi się otwierać.

Działa z Twoim stosem

Zasilaj widżety z narzędzi, które już masz: alert Grafany przełącza lampkę stanu, automatyzacja Home Assistant aktualizuje temperaturę, zadanie GitHub Actions podbija licznik wdrożeń, skrypt crona publikuje wiek kopii zapasowej. Jeśli coś potrafi wysłać żądanie HTTP, może mieć własny widżet.

Zobacz wszystkie integracje →

Widżety i wydarzenia na żywo razem

Widżety i wydarzenia na żywo się uzupełniają: widżet to trwały, otaczający status, który zostaje na ekranie głównym, aż go usuniesz, a wydarzenie na żywo to zadanie z początkiem i końcem, które na czas trwania przypina się do ekranu blokady i Dynamic Island. PushWard steruje oboma przez to samo REST API i ten sam klucz integracji.

Poznaj API wydarzeń na żywo →

Najczęściej zadawane pytania

Czy to oficjalne API WidgetKit od Apple?

Nie. WidgetKit to działający na urządzeniu framework Apple, a korzystanie z niego wprost oznacza zbudowanie i wydanie własnej aplikacji iOS z rozszerzeniem widżetu. PushWard to niezależne API widżetów dla iOS: aplikacja PushWard dostarcza rozszerzenie WidgetKit, a Twoje żądania HTTP decydują, co ono pokazuje.

Jak szybko aktualizują się widżety?

Każdy PATCH wyzwala lekki push, który każe WidgetKit przeładować widżet, więc aktualizacje zwykle docierają w kilka sekund. Ogranicznik pushy per widżet (od 1 sekundy do 1 godziny) scala źródła wysyłające seriami, utrzymując odświeżenia w budżecie, jaki iOS przyznaje rozszerzeniu.

Czy widżety działają na ekranie blokady i w trybie czuwania?

Tak. Widżety PushWard można dodać do ekranu głównego, ekranu blokady i trybu czuwania iPhone'a. Kompaktowe miejsca akcesoriów na ekranie blokady renderują skondensowany układ, a dotknięcie jednego z nich otwiera skonfigurowaną akcję dotknięcia.

Czy odbiorcy muszą mieć zainstalowaną aplikację?

Tak — bezpłatna aplikacja PushWard na iOS (iOS 26 lub nowszy) renderuje widżety i rejestruje je w selektorze widżetów iOS. Nie musisz niczego budować ani zgłaszać do App Store.

Wypróbuj API widżetów dla iOS

Zbuduj ładunek widżetu w playgroundzie i zobacz, jak renderuje się na symulowanym iPhonie, albo przeczytaj przewodnik startowy i zarejestruj pierwszy widżet z curl w kilka minut.