Skip to Content
ガイド認証マネジメントトークン

マネジメントトークン

マネジメントトークンは、管理APIの認証に使うトークンです。 管理APIを使うと、プロジェクトやAPIキーの作成など、コンソールでの操作をプログラムから実行できます。

トークンを発行する

コンソールで、名前と有効期限(デフォルトは30日)を設定してトークンを発行します。 発行できるのは組織のオーナーです。 トークンの値は発行したときと再生成したときにしか表示されないので、すぐにコピーして保存してください。

「マネジメントトークン」の画面

管理APIを呼び出す

マネジメントトークンは Authorization ヘッダーで送ります。 $ACCOUNT_ID には、「組織設定」で確認できる組織IDを指定します。 トークンが使えるのは、発行した組織だけです。

Shell
curl "https://ai-gateway.lolipop.jp/console/v1/accounts/$ACCOUNT_ID" \ -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

プロジェクトを指定するエンドポイントでは、「プロジェクト設定」で確認できるプロジェクトIDを使います。 ほかのエンドポイントは、APIリファレンスの次のページから参照してください。

トークンが使えなくなる場合

管理APIのリクエストは、トークンを発行したオーナーの権限で実行されます。 そのため、次の場合にトークンは使えなくなります。

状況管理APIの応答
有効期限が切れた場合401
発行したオーナーが組織から削除された場合401
発行したオーナーが組織のオーナーでなくなった場合403

トークンを再生成した場合は、その操作をした人の権限に切り替わります。

定期的に実行するプログラムで使う場合は、期限が切れる前に延ばすか、新しいトークンに差し替えてください。

トークンの編集・再生成・無効化

発行したトークンは、名前と有効期限をあとから変更できます。 漏えいした疑いがある場合は再生成してください。新しいトークンが表示され、それまでの値はすぐに使えなくなります。 使わなくなったトークンは、無効化して止めてください。