アプリ管理

アプリとは

todoke の「アプリ」は Push 通知の管理単位です。1 つのアプリが 1 つのサービス（Web サイト）に対応します。アプリごとに独立した VAPID 鍵ペア・購読者・APIキーを持ちます。

アプリの作成

ダッシュボードにログインし「新しいアプリを作成」をクリック
アプリ名を入力して「作成」

作成と同時に P-256 VAPID 鍵ペアが自動生成されます。プライベートキーは AES-GCM で暗号化されサーバー側に保存されるため、ダッシュボードには公開鍵のみ表示されます。

VAPID 公開鍵

アプリ詳細画面の「VAPID Public Key」に表示されている値を、フロントエンドの Service Worker 実装に使います。

// フロントエンド: Push 購読の applicationServerKey に指定
const subscription = await registration.pushManager.subscribe({
  userVisibleOnly: true,
  applicationServerKey: "BNfhTEO47qSR...", // ダッシュボードに表示される値
});

統計

アプリ詳細画面で以下の統計を確認できます。API から直接取得する場合は GET /api/v1/apps/:id/stats（full スコープのキーまたはダッシュボードのセッション）を呼び出します。

項目	レスポンスのフィールド名	説明
アクティブ購読者数	`activeSubscribers`	現在有効な Push 購読の数
総送信数	`totalSent`	アプリ作成以来の通知送信数
失敗数	`totalFailed`	送信に失敗した通知数（購読無効・エラーなど）
今月の送信数	`monthlySent`	現在の月の送信数（プランの上限に対するカウント）

アプリ数の上限

Free プランで作成できるアプリは 1 個までです。上限に達した状態で新しいアプリを作成しようとすると、403 PLAN_LIMIT_EXCEEDED（upgrade_url 付き）が返ります。

アプリの削除

アプリを削除すると、関連する API キー・購読者・月間使用量・送信ログがすべて連鎖的に削除されます。

エラーコードの詳細はエラーコード・制限値を参照してください。