第 12 章 使用令牌交换

来自交换调用的成功响应将返回 HTTP 200 响应代码，其内容类型取决于 requested-token-type 和 requested_issuer。OAuth 请求的令牌类型将返回 JSON 文档，如 OAuth 令牌交换 规格中所述。

{
   "access_token" : ".....",
   "refresh_token" : ".....",
   "expires_in" : "...."
 }

{
   "access_token" : ".....",
   "refresh_token" : ".....",
   "expires_in" : "...."
 }

请求刷新令牌的客户端将在响应中返回访问和刷新令牌。仅请求访问令牌类型的客户端仅在响应中获取访问令牌。对于通过 requested_issuer 参数请求外部签发者的客户端，可能无法包含过期信息。

错误响应通常属于 400 HTTP 响应代码类别，但可能会返回其他错误状态代码，具体取决于错误的严重性。错误响应可能会包含的内容，具体取决于 requested_issuer。基于 OAuth 的交换可能会返回 JSON 文档，如下所示：

{
   "error" : "...."
   "error_description" : "...."
}

{
   "error" : "...."
   "error_description" : "...."
}

根据交换类型，可能会返回其他错误声明。例如，如果用户没有到身份提供程序的链接，OAuth 身份提供程序可能包含额外的 account-link-url 声明。此链接可用于客户端发起的链接请求。

本章的其余部分讨论了设置要求，并为不同的交换场景提供示例。为了简单起见，让我们调用当前域以 内部 令牌为 mint 的令牌，以及外部域或身份提供程序以 外部 令牌为 mint 的令牌。