高度な機能

Webhooks

残高不足、利用上限、アカウント変更など、重要なイベントのリアルタイム通知を受け取れます。メール・Webhook・Bark・Gotify のいずれかで、すべてご自身のアカウントから設定できます。

通知を受け取るタイミング

アカウントで重要なことが起きたとき（最も一般的なのは残高と利用状況）に通知を受け取ります：

  • 残高不足 — 残高が尽きる前にチャージできます
  • 利用量・クォータ通知 — 設定した上限に近づいたとき
  • アカウントイベント — アカウントや API キーの状態変更

通知の設定

  1. api.tokspan.com/profile にログインします
  2. 設定と環境設定（Settings & Preferences）を開きます
  3. 通知（Notifications）で配信チャネルを選択：Email・Webhook・Bark・Gotify
  4. Webhook 配信の場合は、HTTPS エンドポイント URL を入力し、購読するイベントを選択します
  5. 保存すると、イベント発生時にリアルタイムで通知されます
通知エンドポイントを保護してください。公開の Webhook URL を使用する場合は、TokSpan から届いた通知のみを処理し、2xx ステータスで受信を確認してください。通知設定で共有シークレットまたは署名オプションが提供されている場合は、有効化してエンドポイントをさらに保護することを推奨します。