API キー

API キーの作成

ダッシュボードでアプリを選択
「API Keys」セクションでキー名を入力しスコープを選択
「作成」をクリック — キーはこのとき一度だけ表示されます

スコープ

スコープ	用途	許可される操作
`subscribe_only`	フロントエンド埋め込み	購読の登録・解除のみ
`notify`	サーバーサイド通知送信	通知送信 + 購読操作
`full`	管理用	全操作（アプリ情報取得・統計含む）

使い分けの例

ユーザーのブラウザ (フロントエンド)
  └─ subscribe_only キー → /api/v1/apps/:id/subscriptions (POST/DELETE)

自社サーバー (バックエンド)
  └─ notify キー → /api/v1/notify (POST)

CI / 管理スクリプト
  └─ full キー → 全エンドポイント

認証方法

API キーは Authorization: Bearer ヘッダーで送信します。

curl -H "Authorization: Bearer pk_your_key_here" \
  https://todoke-api.naoto24kawa.workers.dev/api/v1/notify \
  -H "Content-Type: application/json" \
  -d '{"app_id":"...","title":"test","body":"test"}'

キーの形式

pk_a1b2c3d4e5f6...  (64文字の16進数)

キーの削除

キーを削除すると即座に無効化されます。そのキーを使っているアプリケーションは認証エラーになります。削除したキーは復元できません。