第 7 章 使用令牌交换

来自交换调用的成功响应将返回 HTTP 200 响应代码，它带有依赖于 requested-token-type 和 requested_issuer 请求的内容类型。OAuth 请求的令牌类型将返回 JSON 文档，如 OAuth Token Exchange 规范中所述。

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

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

请求刷新令牌的客户端将在响应中返回访问和刷新令牌。仅请求访问令牌类型的客户端仅获得响应中的访问令牌。通过 requested_issuer paramater 请求外部签发者的客户端可能会包含过期信息。

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

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

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

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

本章的其余部分介绍了设置要求，并为不同的交换场景提供示例。为了简单起见，可以将当前域报告为 内部 令牌来报告令牌，以及由外部域或身份提供程序报告的令牌作为 外部 令牌。