API Дій наживо на iOS для всього, що говорить HTTP

Що таке Дія наживо?

Дія наживо — це функція iOS, яка показує живу, зрозумілу з першого погляду інформацію на замкненому екрані, у Dynamic Island і в режимі «Очікування» — без того, щоб отримувач будь-коли відкривав застосунок. На відміну від push-сповіщення, що з'являється один раз і губиться в списку, Дія наживо лишається закріпленою та оновлюється в реальному часі: збірка проходить свої кроки, таймер веде зворотний відлік, доставка наближається. PushWard перетворює один HTTP-запит саме на це.

Дії наживо від Apple — без ActivityKit

Дії наживо — це функція iOS від Apple, що з'явилася в iOS 16.1: зрозумілі з першого погляду поверхні реального часу, закріплені на замкненому екрані та в Dynamic Island. Зазвичай, щоб створити таку, треба випустити власний iOS-застосунок із віджет-розширенням ActivityKit, запитувати токени push-to-start і самому спілкуватися з APNs. PushWard замінює все це одним REST API: застосунок PushWard відображає вашу Дію наживо, а один HTTP-запит запускає, оновлює або завершує її.

Як працює API

Створіть активність, запустіть її, оновлюйте та завершіть — усе через REST API PushWard із вашим ключем інтеграції. Будь-який сервіс, здатний надіслати HTTP-запит, може керувати тим, що люди бачать з першого погляду. Не потрібні сертифікати APNs, і жодного клієнтського коду писати не треба; доставку через Apple Push Notification service бере на себе PushWard.

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

Шаблон для кожного типу оновлень

Обирайте з шаблонів Дій наживо, створених для різних завдань — універсальна смуга прогресу, зворотний відлік, послідовність кроків, сповіщення, індикатор, спарклайн часової шкали, дошка плиток або живий журнал подій. Кожен має макет, підлаштований під замкнений екран і Dynamic Island.

Переглянути шаблони →

Працює з вашим стеком

Надсилайте Дії наживо просто з інструментів, які ви вже використовуєте. Готові мости та розміщений webhook-relay покривають алерти Grafana, автоматизації Home Assistant, GitHub Actions, завантаження SABnzbd, друк Bambu Lab, синхронізації ArgoCD і все інше, що вміє надсилати JSON.

Усі інтеграції →

Часті запитання

Це офіційний API Дій наживо від Apple?

Ні. Офіційний фреймворк Apple — ActivityKit, який вимагає створити та випустити власний iOS-застосунок. PushWard — незалежний API Дій наживо для iOS: він доставляє ваші оновлення через Apple Push Notification service до застосунку PushWard, який відображає їх на замкненому екрані та в Dynamic Island.

Чи можу я запустити Дію наживо із сервера?

Так — у цьому й суть. Будь-який сервер, скрипт чи автоматизація, здатні надіслати HTTP-запит, можуть створити, запустити, оновити та завершити Дію наживо. PushWard бере на себе процес push-to-start від Apple, тож активність з'являється без того, щоб отримувач відкривав застосунок.

Чи потрібен отримувачам встановлений застосунок?

Так — безплатний iOS-застосунок PushWard відображає Дію наживо. Вам нічого не треба створювати, підписувати чи надсилати в App Store; отримувачі один раз встановлюють PushWard, і ваші запити керують їхнім замкненим екраном.

Які iPhone підтримують Дії наживо?

Застосунку PushWard потрібна iOS 26 або новіша. На iPhone з Dynamic Island Дія наживо закріплюється в самому «острові»; на моделях без нього вона з'являється на замкненому екрані та в режимі «Очікування».

Спробуйте API Дій наживо для iOS

Подивіться в playground, як Дія наживо з'являється на симульованому iPhone, або прочитайте посібник із початку роботи й надішліть першу за кілька хвилин за допомогою curl.