為一切會說 HTTP 的事物打造的 iOS 即時動態 API

什麼是即時動態？

即時動態是 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 負責送達。

# 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 傳送您的第一個。