面向一切会说 HTTP 的事物的 iOS 实时活动 API

PushWard 是一个面向 Apple 实时活动的 API：发送一个 HTTP 请求，它就会实时出现在 iPhone 的锁定屏幕和灵动岛上，持续实时更新，任务完成后自动消失。无需 ActivityKit 代码，无需 Xcode，您这边也无需 App Store 审核。

什么是实时活动？

实时活动是 iOS 的一项功能，可在锁定屏幕、灵动岛和待机显示中呈现实时、一目了然的信息 — 接收者完全不必打开任何应用。与出现一次就沉入列表的推送通知不同，实时活动会保持固定并实时更新：逐步推进的构建、倒计时的计时器、越来越近的配送。PushWard 把一个 HTTP 请求变成这样的体验。

Apple 的实时活动，无需 ActivityKit

实时活动是 Apple 在 iOS 16.1 中引入的 iOS 功能：固定在锁定屏幕和灵动岛上、一目了然的实时展示面。通常要构建一个，意味着发布带有 ActivityKit 小组件扩展的自有 iOS 应用、请求 push-to-start 令牌，并亲自与 APNs 打交道。PushWard 用一个 REST API 取代了这一切：PushWard 应用负责渲染您的实时活动，一个 HTTP 请求即可启动、更新或结束它。

API 如何工作

创建活动、启动、更新、结束 — 全部通过 PushWard 的 REST API 和您的集成密钥完成。任何能发送 HTTP 请求的服务，都能驱动人们一眼看到的内容。没有 APNs 证书，也不用编写客户端代码；PushWard 通过 Apple Push Notification service 负责送达。

通过 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"
  } }'

每种更新都有对应的模板

从为不同场景打造的实时活动模板中挑选 — 通用进度条、倒计时、步骤序列、警报、仪表、时间线迷你图、磁贴看板或实时事件日志。每个模板都有为锁定屏幕和灵动岛调校的布局。

浏览模板 →

与您的技术栈协同工作

直接从您已在运行的工具发送实时活动。现成的桥接和托管的 webhook relay 覆盖 Grafana 警报、Home Assistant 自动化、GitHub Actions、SABnzbd 下载、Bambu Lab 打印、ArgoCD 同步，以及任何能发送 JSON 的服务。

查看所有集成 →

常见问题

这是 Apple 官方的实时活动 API 吗？

不是。Apple 的官方框架是 ActivityKit，需要构建并发布您自己的 iOS 应用。PushWard 是一个独立的 iOS 实时活动 API：它通过 Apple Push Notification service 将您的更新送达 PushWard 应用，由该应用在锁定屏幕和灵动岛上渲染。

我可以从服务器启动实时活动吗？

可以 — 这正是它的意义所在。任何能发送 HTTP 请求的服务器、脚本或自动化流程都可以创建、启动、更新和结束实时活动。PushWard 为您处理 Apple 的 push-to-start 流程，因此接收者无需打开应用，活动就会出现。

接收者需要安装应用吗？

需要 — 免费的 PushWard iOS 应用负责渲染实时活动。您无需构建、签名或向 App Store 提交任何东西；接收者只需安装一次 PushWard，您的请求就能驱动他们的锁定屏幕。

哪些 iPhone 支持实时活动？

PushWard 应用需要 iOS 26 或更高版本。在配备灵动岛的 iPhone 上，实时活动会停靠在灵动岛中；在没有灵动岛的机型上，它会出现在锁定屏幕和待机显示中。

试用 iOS 实时活动 API

在 playground 中观看实时活动出现在模拟 iPhone 上，或阅读入门指南，几分钟内用 curl 发送您的第一个。