Skip to main content
サーバーAPIキー(sk_live_...)は、ThunderPhone API へのサーバー間呼び出しを認証します。キーは 組織 → キー にあります。
サーバーキーはシークレットです。クライアント側コードには絶対に含めないでください。ブラウザでは代わりに、オリジンにロックされた 公開可能キーpk_live_...) を使用してください。
1

キーのタブを開く

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

名前を付ける

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

キーを作成する

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

すぐにコピーする

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

使用する

キーはこの組織に紐付いているため、リクエストに組織IDは不要です。Bearer ヘッダーのみを指定します。
ここから、API クイックスタートでさらに3つのリクエストを行うと、最初の通話を実行できます。

ローテーションと取り消し

新しいキーを作成し、サービスを移行してから、同じタブで古いキーを削除します。一覧には各キーのプレフィックスと名前が表示されるため、区別できます。キーはプログラムからも開発者 API キーのリファレンスで管理できます。
サーバーAPIキーはマシン認証情報であり、組織のパスキーを必須にする ポリシーの対象外です。この設定は sk_live_... キーではなく、人によるログインを確認します。 そのため、キーをここで速やかにローテーションおよび取り消すことが、継続的なAPIアクセスを制御する主な方法です。パスキーが必須の場合、セキュリティポリシーパネルには、現在対象外となっている有効なキーの数が表示されます。
アプリ内コパイロットに「APIキーを作成」と依頼すると、各コントロールをリアルタイムで強調表示しながら、この手順を案内します。

次のステップ

API クイックスタート

エージェント、番号、Webhook、最初の通話。REST 呼び出しは4回です。

認証リファレンス

Bearer 認証と組織への紐付けの仕組み。