API Эфиров активности iOS для всего, что говорит по HTTP

PushWard — это API для Эфиров активности Apple: отправьте один HTTP-запрос, и он появится вживую на экране блокировки и в Dynamic Island iPhone, будет обновляться в реальном времени и сам исчезнет, когда задача завершится. Никакого кода ActivityKit, никакого Xcode, никакой проверки в App Store с вашей стороны.

Что такое Эфир активности?

Эфир активности — это функция 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.

Запуск, обновление и завершение Эфира активности по HTTP

# 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 за несколько минут.