HTTP を話せるすべてのもののための iOS Live Activity API

Live Activity とは？

Live Activity は、Lock Screen、Dynamic Island、StandBy にライブで一目で分かる情報を表示する iOS の機能で、受信者がアプリを開く必要はありません。一度表示されてリストに埋もれていくプッシュ通知と違い、Live Activity は固定されたままリアルタイムに更新されます。ステップを進むビルド、カウントダウンするタイマー、近づいてくる配達。PushWard は 1 つの 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"
  } }'

あらゆる更新に合うテンプレート

用途別に作られた Live Activity テンプレートから選べます — 汎用のプログレスバー、カウントダウン、ステップシーケンス、アラート、ゲージ、タイムラインのスパークライン、タイルのボード、ライブイベントログ。それぞれ Lock Screen と Dynamic Island に合わせて調整されたレイアウトを備えています。

テンプレートを見る →

あなたのスタックで動く

すでに運用しているツールから直接 Live Activities を送信。既製のブリッジとホスト型の webhook relay が、Grafana のアラート、Home Assistant のオートメーション、GitHub Actions、SABnzbd のダウンロード、Bambu Lab のプリント、ArgoCD の同期、そして JSON を送れるあらゆるものをカバーします。

すべての統合を見る →

iOS Live Activity API を試す

playground でシミュレートされた iPhone に Live Activity が届く様子を見るか、入門ガイドを読んで数分で最初の 1 つを curl で送ってみましょう。