文档Adobe PassAdobe Pass 身份验证

检索客户端凭据 retrieve-client-credentials

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

请求 request

HTTP
路径
/o/client/register
方法
POST
正文参数
software_statement
与从Adobe Pass TVE Dashboard创建和下载的注册应用程序关联的软件语句。

已注册应用程序的管理在Dynamic Client注册概述文档中进行了说明。
必填
redirect_uri
验证流完成后，与用户代理导航到的位置关联的重定向URI。
可选
标头
Content-Type
所发送资源的接受媒体类型。

它必须是application/json。
必填
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 6-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 25-bgcolor-deebff layout-auto html-authored
属性
client_id 客户端应用程序标识符字符串。 必填
clientsecret 客户端应用程序密码字符串。 必填
client_id_issued_at 发出客户端应用程序标识符的时间。 必填
redirect_uris 客户端应用程序可在基于重定向的流中使用的重定向URI字符串数组。 必填
grant_type 客户端应用程序可用于客户端令牌端点的授权类型字符串。 必填
范围 定义客户端应用程序可以使用的Adobe Pass身份验证API的范围字符串。 必填
必填

错误 error

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

可能的值包括：

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

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

  • 请求缺少所需的参数。
  • 该请求包含不支持的参数值。
  • 该请求会重复一个参数。
  • 请求的格式不正确。
invalid_redirect_uri 该请求包含重定向URI的值，该值无效。
invalid_software_statement 该请求包含无效的软件语句值。
unapproved_software_statement 该请求包含软件语句的值，但该值未获准供Adobe Pass身份验证服务器使用。
必填

示例 samples

检索客户端凭据 samples-retrieve-client-credentials

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

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

{
    "software_statement": "eyJhbGciOiJSUzI1NiJ9.
        eyJzb2Z0d2FyZV9pZCI6IjROUkIxLTBYWkFCWkk5RTYtNVNNM1IiLCJjbGll
        bnRfbmFtZSI6IkV4YW1wbGUgU3RhdGVtZW50LWJhc2VkIENsaWVudCIsImNs
        aWVudF91cmkiOiJodHRwczovL2NsaWVudC5leGFtcGxlLm5ldC8ifQ.
        GHfL4QNIrQwL18BSRdE595T9jbzqa06R9BT8w409x9oIcKaZo_mt15riEXHa
        zdISUvDIZhtiyNrSHQ8K4TvqWxH6uJgcmoodZdPwmWRIEYbQDLqPNxREtYn0
        5X3AR7ia4FRjQ2ojZjk5fJqJdQ-JcfxyhK-P8BAWBd6I2LLA77IG32xtbhxY
        fHX7VhuU5ProJO8uvu3Ayv4XRhLZJY4yKfmyjiiKiPNe-Ia4SMy_d_QSWxsk
        U5XIQl5Sa2YRPMbDRXttm2TfnZM1xx70DoYi8g6czz-CPGRi4SW_S2RKHIJf
        IjoI3zTJ0Y2oe0_EJAiXbL6OyF9S5tKxDXV8JIndSA",
    "redirect_uri": "adobepass://com.programmer"
 }
响应 — 成功
code language-https 
HTTP/1.1 201 Created

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

{
    "client_id": "s6BhdRkqt3",
    "client_secret": "t7AkePiru4",
    "redirect_uris": [
        "app://com.programmer.adobe#sdasdsadas"
    ],
    "grant_types": [
        "client_credentials"
    ],
    "scopes": [
        "api:client:v2"
    ],
    "client_id_issued_at": 1723227212
}
响应 — 错误
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