文档Adobe PassAdobe Pass 身份验证

检索访问令牌 retrieve-access-token

Last update: Mon Aug 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
此页面上的内容仅供参考。 使用此API需要来自Adobe的当前许可证。 不允许未经授权使用。
IMPORTANT
动态客户端注册API实现受限制机制文档限制。

请求 request

HTTP
路径
/o/client/token
方法
POST
正文参数
client_id
客户端应用程序标识符字符串。

有关如何获取客户端标识符字符串的更多信息，请参阅检索客户端凭据 API文档。
必填
clientsecret
客户端应用程序密码字符串。

有关如何获取客户端密钥字符串的更多信息，请参阅检索客户端凭据 API文档。
必填
grant_type
客户端应用程序可用于客户端令牌端点的授权类型字符串（例如“client_credentials”）。

有关如何获取授权类型字符串的更多信息，请参阅检索客户端凭据 API文档。
必填
标头
Content-Type
所发送资源的接受媒体类型。

必须是application/x-www-form-urlencoded。
必填
X-Device-Info
X-Device-Info文档中介绍了设备信息有效负载的生成。

强烈建议在应用程序的设备平台允许显式提供有效值时始终使用它。

提供该属性后，Adobe Pass身份验证后端将隐式地将显式设置的值与提取的值合并（默认情况下）。

如果未提供，Adobe Pass身份验证后端将隐式使用提取的值（默认情况下）。
必填
Accept
客户端应用程序接受的媒体类型。

如果指定，则必须是application/json。
可选
User-Agent
客户端应用程序的用户代理。
可选

响应 response

成功 success

标头
状态
201
必填
Content-Type
application/json
必填
正文

具有以下属性的JSON对象：

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff layout-auto html-authored
属性
id 可用于跟踪用户活动的不透明标识符。 必填
access_token 客户端应用程序必须用于Authorization标头的访问令牌值。 必填
created_at 颁发访问令牌的时间。 必填
expires_in 访问令牌过期之前的秒数。 必填
token_type 令牌类型（例如，“持有者”）。 必填
必填

错误 error

标头
状态
400
必填
Content-Type
application/json
必填
正文
错误

可能的值包括：

table 0-row-3 1-row-2 2-row-2 3-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff layout-auto html-authored
值
invalid_request

由于以下原因之一，该请求无效：

  • 请求缺少所需的参数。
  • 该请求包含不支持的参数值（授予类型除外）。
  • 该请求会重复一个参数。
  • 该请求包含多个凭据。
  • 该请求使用多种机制来验证客户端。
  • 请求的格式不正确。
invalid_client 客户端凭据无效，客户端需要获取新的客户端凭据并重试。 有关更多详细信息，请参阅检索客户端凭据 API文档。
unauthorized_client 使用的授权类型无效。
必填

示例 samples

检索访问令牌 samples-retrieve-access-token

请求
code language-https 
POST /o/client/token HTTP/1.1

    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Content-Type: application/x-www-form-urlencoded
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

client_id=s6BhdRkqt3&client_secret=t7AkePiru4&grant_type=client_credentials
响应 — 成功
code language-https 
HTTP/1.1 201 Created

Content-Type: application/json;charset=UTF-8

{
  "id": "a932f8f0-210a-41a4-b2a8-377751f6b76f",
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "created_at": 1723227212,
  "expires_in": 86400,
  "token_type": "bearer"
}
响应 — 错误
code language-https 
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b