检索授权令牌 retrieve-authorization-token
NOTE
此页面上的内容仅供参考。 使用此API需要来自Adobe的当前许可证。 不允许未经授权使用。
NOTE
REST API实现受限制机制限制
REST API端点 clientless-endpoints
<REGGIE_FQDN>：
- 生产 — api.auth.adobe.com
- 暂存 — api.auth-staging.adobe.com
<SP_FQDN>：
- 生产 — api.auth.adobe.com
- 暂存 — api.auth-staging.adobe.com
描述 description
检索授权(AuthZ)令牌。
端点
调用者
输入
参数
参数
HTTP
方法
方法
响应
HTTP
响应
响应
<SP_FQDN>/api/v1/tokens/authz
例如：
<SP_FQDN>/api/v1/tokens/authz
例如：
<SP_FQDN>/api/v1/tokens/authz
流式处理应用程序
或
程序员服务
或
程序员服务
1.请求者（必需）
2。 deviceId （必需）
3。 资源（必需）
4。 device_info/X-Device-Info （必需）
5。 deviceType
6。 deviceUser （已弃用）
7。 appId（已弃用）
2。 deviceId （必需）
3。 资源（必需）
4。 device_info/X-Device-Info （必需）
5。 deviceType
6。 deviceUser （已弃用）
7。 appId（已弃用）
GET
1.成功
2。 身份验证令牌
未找到或已过期：
XML说明原因
找不到authn令牌
3。 授权令牌
未找到：
XML说明
4。 授权令牌
已过期：
XML说明
2。 身份验证令牌
未找到或已过期：
XML说明原因
找不到authn令牌
3。 授权令牌
未找到：
XML说明
4。 授权令牌
已过期：
XML说明
200 — 成功
412 — 无身份验证
404 — 无身份验证
410 — 身份验证已过期
412 — 无身份验证
404 — 无身份验证
410 — 身份验证已过期
输入参数
描述
请求者
此操作有效的程序员requestorId。
deviceId
设备ID字节。
资源
一个字符串，它包含resourceId（或MRSS片段），标识用户请求的内容并被MVPD授权端点识别。
设备信息/
X — 设备信息
X — 设备信息
流设备信息。
注意：可以将此device_info作为URL参数传递，但由于此参数的潜在大小以及GETURL的长度限制，它应作为X-Device-Info传递到http标头。
在传递设备和连接信息中查看完整的详细信息。
注意：可以将此device_info作为URL参数传递，但由于此参数的潜在大小以及GETURL的长度限制，它应作为X-Device-Info传递到http标头。
在传递设备和连接信息中查看完整的详细信息。
deviceType
设备类型（例如，Roku、PC）。
如果该参数设置正确，ESM提供的量度在使用无客户端程序时按设备类型🔗进行划分，以便可以执行不同类型的分析，例如Roku、AppleTV和Xbox。
查看，在传递量度中使用无客户端设备类型参数的好处
注意： device_info将替换此参数。
如果该参数设置正确，ESM提供的量度在使用无客户端程序时按设备类型🔗进行划分，以便可以执行不同类型的分析，例如Roku、AppleTV和Xbox。
查看，在传递量度中使用无客户端设备类型参数的好处
注意： device_info将替换此参数。
设备用户
设备用户标识符。
appId
应用程序id/名称。
注意： device_info将替换此参数。
注意： device_info将替换此参数。
示例响应 response
成功
XML：
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<authorization>
<expires>1348148289000</expires>
<mvpd>sampleMvpdId</mvpd>
<requestor>sampleRequestorId</requestor>
<resource>sampleResourceId</resource>
<proxyMvpd>sampleProxyMvpdId</proxyMvpd>
</authorization>
JSON：
{
"mvpd": "sampleMvpdId",
"resource": "sampleResourceId",
"requestor": "sampleRequestorId",
"expires": "1348148289000",
"proxyMvpd": "sampleProxyMvpdId"
}
未找到身份验证令牌或已过期：
XML：
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<error>
<status>412</status>
<message>User not authenticated</message>
</error>
JSON：
{
"status": 412,
"message": "User not authenticated",
"details": null
}
未找到授权令牌：
XML：
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<error>
<status>404</status>
<message>Not found</message>
</error>
JSON：
{
"status": 404,
"message": "Not Found",
"details": null
}
授权令牌已过期：
XML：
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<error>
<status>410</status>
<message>Gone</message>
</error>
JSON：
{
"status": 410,
"message": "Gone",
"details": null
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b