サーバーAPIキーを作成する

ThunderPhone API へのサーバー間呼び出し用に、ダッシュボードから sk_live_ シークレットキーを発行します。安全に保管し、必要に応じてローテーションまたは無効化してください。

サーバーAPIキー（sk_live_...）は、ThunderPhone API へのサーバー間呼び出しを認証します。キーは 組織 → キー にあります。

1. キーのタブを開く

   組織 → キー に移動し、キーを作成 をクリックします。

2. 名前を付ける

   「本番バックエンド」など、キーを使用する場所がわかる名前を付けます。名前はラベルにすぎず、アクセスには影響しません。

3. キーを作成する

   ダイアログで キーを作成 をクリックします。これによりシークレットが生成されます。

4. すぐにコピーする

   完全なシークレットは 一度だけ 表示されます。シークレットマネージャーにコピーしてください。画面を離れた後は、プレフィックスのみが表示されます。

使用する#

キーはこの組織に紐付けられているため、リクエストに組織IDは不要です。必要なのは Bearer ヘッダーだけです。

curl https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ここから、APIクイックスタートでさらに3回のリクエストを行うと、最初の通話を実行できます。

ローテーションと失効#

新しいキーを作成し、サービスを移行してから、同じタブで古いキーを削除します。リストには各キーのプレフィックスと名前が表示されるため、区別できます。ローテーションをスクリプト化するには、ログイン済みセッショントークンを使用して開発者 API キーエンドポイントを呼び出します。sk_live_ キーではキーの作成、一覧表示、取り消しはできないため、漏洩したキーが自身の代替キーを作成することはありません。これは、メンバー、招待、支払い設定、その他のアカウント管理にも同様に適用されます。

次のステップ#