文件Adobe PassAdobe Pass 驗證

擷取使用者端認證 retrieve-client-credentials

Last update: Fri Dec 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
IMPORTANT
Dynamic Client Registration API實作已由節流機制檔案限制。

請求 request

HTTP
路徑
/o/client/register
方法
POST
主體引數
software_statement
與從Adobe Pass TVE Dashboard建立和下載的註冊應用程式關聯的軟體陳述式。

已註冊應用程式的管理在動態使用者端註冊概述檔案中有所說明。
必填
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 使用者端應用程式識別碼字串。 必填
client_secret 使用者端應用程式密碼字串。 必填
client_id_issued_at 發出使用者端應用程式識別碼的時間。 必填
redirect_uris 使用者端應用程式可在重新導向型流程中使用的重新導向URI字串陣列。 必填
grant_types 使用者端應用程式可用於使用者端權杖端點的授與型別字串。 必填
範圍 定義使用者端應用程式可使用的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