Skip to main content

​
エンドポイント

POST /oauth/token トークンベースの認証では、oauth/token エンドポイントを使用して、アプリケーションが保護された API に対して認証済みの呼び出しを行うためのアクセストークンを取得します。必要に応じて、ID トークンやリフレッシュトークンを取得することもできます。ID トークンには、アプリケーションが抽出してよりよいユーザー体験の提供に役立てられる、スコープの形のユーザー情報が含まれています。リフレッシュトークンを使用すると、現在のトークンの有効期限が切れたあとでも、ユーザー体験を損なうことなく、アプリケーションで新しいアクセストークンをリクエストできます。詳しくは、ID Tokens と Refresh Tokens を参照してください。 リフレッシュトークンを取得できる OAuth 2.0 フローは、次のものに限られます。 これは、一般的な Web アプリが API にアクセスする際に使用するフローです。このエンドポイントを使って、Authorization Code をトークンに交換します。

​
ヘッダー

​
string
リクエスト用の DPoP プルーフです。これは任意項目で、アプリケーションで Demonstrating Proof-of-Possession を使用している場合にのみ必要です。

​
リクエストボディのパラメータ

リクエストボディは application/x-www-form-urlencoded 形式です。
​
string
必須
使用するフローを指定します。認可コード の場合は authorization_code を使用します。
​
string
必須
アプリケーションの Client ID です。
​
string
必須
アプリケーションの Client Secret です。
​
string
必須
最初の /authorize 呼び出しで受け取った 認可コード です。
​
string
GET /authorize エンドポイントで設定している場合にのみ必要です。/authorize で指定した値は、/oauth/token で設定する値と一致している必要があります。

​
レスポンススキーマ

​
エージェントアクセストークン

認可コードを交換するアプリケーションがエージェントにリンクされ、対象 API でエージェントの subject クレームが有効になっている場合、発行されるアクセストークンには、ユーザーに代わって動作する actor としてエージェントが記録されます。
  • sub クレームは引き続きユーザー識別子です。エージェントのアイデンティティは sub ではなく act クレームに示されます。
  • act クレームはエージェントを識別します: { "sub": "agt_72jbvv7LfRKYp59gtRLtkn", "sub_profile": "ai_agent", "client_id": "YOUR_CLIENT_ID", "iss": "https://YOUR_DOMAIN/" }。
  • トークンには sub_profile: "user" と、たとえば web_app ai_agent のように ai_agent 接尾辞が付いた client_profile が含まれます。
アクセストークンにセッション転送または On-Behalf-Of トークン交換による actor がすでに含まれている場合は、その actor が優先され、エージェントの actor は追加されません。これらのクレームはアクセストークンにのみ適用され、ID トークンには影響しません。レスポンスオブジェクトのスキーマは変更されません。詳細については、Access Token Profilesを参照してください。

​
レスポンスメッセージ