HTTP を話せるすべてのもののための iOS ウィジェット API

PushWard は Apple の iOS ウィジェットのための API です。ウィジェットを一度宣言すれば、あとはただの HTTP リクエストで iPhone のホーム画面・ロック画面・スタンバイを動かせます。更新のたびにプッシュ駆動の WidgetKit リフレッシュが走ります — ポーリングも、WidgetKit のコードも、Xcode も、あなた側での App Store 審査も不要です。

iOS のホーム画面ウィジェットとは？

ウィジェットは Apple の「一目で分かる」表示面です。iPhone のホーム画面・ロック画面・スタンバイに常時表示される小さなタイルで、アプリを開かずに情報を見せます。Apple のオンデバイスフレームワークである WidgetKit で作られ、通常はそれぞれが、自分で開発・署名・出荷しなければならないアプリに属します。PushWard のウィジェットは違います。PushWard アプリが描画し、その内容はあなたの API 呼び出しから届きます — センサーの読み値、サーバーのヘルスチェック、デプロイのカウンター、JSON で送れるものなら何でも。

API の仕組み

POST でウィジェットを登録し、PATCH で更新する — ループはそれだけです。更新のたびに Apple Push Notification service 経由で軽量なプッシュが送られ、WidgetKit にウィジェットのタイムラインの再読み込みを指示します。ウィジェットが一切ポーリングすることなく新しい値が表示されます。ウィジェットごとのオプションのプッシュスロットルが、バースト気味のソースをまとめます。

HTTP でウィジェットを登録・更新する

# 1. Register a widget
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "cpu-load", "name": "CPU Load", "content": {
    "template": "progress", "value": 0.42,
    "label": "load avg", "icon": "cpu", "accent_color": "cyan"
  } }'

# 2. Update it - WidgetKit refreshes the widget
curl -X PATCH https://api.pushward.app/widgets/cpu-load \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "content": { "value": 0.78, "accent_color": "orange" } }'

10 種類のウィジェットテンプレート

データに合うレイアウトを選べます。単一の値、進捗バー、ステータスライト、ゲージ、統計リスト、トレンドのスパークライン、カウントダウン、バッテリー残量、スケジュール、エンドポイント間のフロー。どのテンプレートも PushWard アプリがネイティブに描画するので、デザイン作業なしでデータが洗練されたレイアウトに収まります。

ウィジェットテンプレートを見る →

動かせるインタラクティブなウィジェット

ウィジェットには最大 3 つのタップアクションを持たせられます。ホーム画面を離れずにサイレントな Webhook を発火する、別のアプリにディープリンクする、URL を開く。サーバーの再起動、ショートカットの実行、アラートの確認をウィジェットから直接 — PushWard アプリを開く必要は一度もありません。

あなたのスタックで動く

すでに運用しているツールからウィジェットにデータを供給できます。Grafana のアラートがステータスライトを切り替え、Home Assistant のオートメーションが温度を更新し、GitHub Actions のジョブがデプロイカウンターを進め、cron スクリプトがバックアップの経過時間を送信する。HTTP リクエストを送れるものなら、ウィジェットを持てます。

すべての連携を見る →

ウィジェットとライブアクティビティを一緒に

ウィジェットとライブアクティビティは補完関係にあります。ウィジェットは取り除くまでホーム画面に残る、持続的でさりげないステータス。ライブアクティビティは始まりと終わりのあるタスクで、実行中はロック画面と Dynamic Island に固定されます。PushWard は同じ REST API と同じ統合キーで両方を動かします。

ライブアクティビティ API について →

よくある質問

これは Apple 公式の WidgetKit API ですか？

いいえ。WidgetKit は Apple のオンデバイスフレームワークで、直接使うにはウィジェット拡張を含む自前の iOS アプリを開発して出荷する必要があります。PushWard は独立した iOS ウィジェット API です。PushWard アプリが WidgetKit 拡張を同梱し、あなたの HTTP リクエストが表示内容を決めます。

ウィジェットはどれくらい速く更新されますか？

PATCH のたびに WidgetKit にウィジェットの再読み込みを指示する軽量なプッシュが送られるため、更新は通常数秒以内に反映されます。ウィジェットごとのプッシュスロットル（1 秒〜1 時間）がバースト気味のソースをまとめ、iOS が拡張に与えるリフレッシュ予算の範囲内に保ちます。

ウィジェットはロック画面とスタンバイでも動きますか？

はい。PushWard のウィジェットは iPhone のホーム画面、ロック画面、スタンバイに追加できます。ロック画面のコンパクトなアクセサリスロットでは凝縮されたレイアウトが描画され、タップすると設定済みのタップアクションが開きます。

受信者はアプリのインストールが必要ですか？

はい — 無料の PushWard iOS アプリ（iOS 26 以降）がウィジェットを描画し、iOS のウィジェットピッカーに登録します。あなたが開発したり App Store に提出したりするものは何もありません。

iOS ウィジェット API を試す

playground でウィジェットのペイロードを組み立ててシミュレートされた iPhone に描画される様子を見るか、入門ガイドを読んで数分で最初のウィジェットを curl で登録してみましょう。