文件Adobe PassAdobe Pass 驗證

使用程式碼擷取驗證工作階段 retrieve-authentication-session-using-code

Last update: Tue Oct 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
IMPORTANT
REST API V2實作受到節流機制檔案的限制。

請求 request

HTTP
路徑
/api/v2/{serviceProvider}/sessions/{code}
方法
GET
路徑引數
服務提供者
在上線流程中與服務提供者相關聯的內部唯一識別碼。
必填
程式碼
在串流裝置上建立驗證工作階段後取得的驗證代碼。
必填
標頭
Authorization
在授權標標頭檔案中說明了持有人權杖承載的產生。
必填
X-Forwarded-For
串流裝置的IP位址。

強烈建議一律將它用於伺服器對伺服器的實作，尤其是當呼叫是由程式設計人員服務（而非串流裝置）進行時。

對於使用者端對伺服器實作，會以隱含方式傳送串流裝置的IP位址。
可選
Accept
使用者端應用程式接受的媒體型別。

若指定，則必須是application/json。
可選
User-Agent
使用者端應用程式的使用者代理。
可選

回應 response

程式碼
文字
說明
200
確定
回應內文包含驗證工作階段的相關資訊。
400
錯誤請求
請求無效，使用者端需要修正請求，然後再試一次。 回應本文可能包含遵守增強錯誤碼檔案的錯誤資訊。
401
未獲授權
存取權杖無效，使用者端需要取得新的存取權杖並重試。 如需詳細資訊，請參閱動態使用者端註冊概觀檔案。
405
不允許的方法
HTTP方法無效，使用者端需要使用請求資源所允許的HTTP方法，然後再試一次。 如需詳細資訊，請參閱要求區段。
500
內部伺服器錯誤
伺服器端發生問題。 回應本文可能包含遵守增強錯誤碼檔案的錯誤資訊。

成功 success

標頭
狀態
200
必填
內文
引數

具有以下屬性的JSON物件：

  • existing
    已經提供的現有引數。
  • 遺失
    遺失完成驗證流程所需的引數。
必填

錯誤 error

標頭
狀態
400， 401， 405， 500
必填
Content-Type
application/json
必填
內文
回應內文可能會提供其他錯誤資訊，這些資訊會遵守增強型錯誤碼檔案。
必填

範例 samples

1.擷取驗證工作階段，但不遺失引數

要求
code language-https 
GET /api/v2/sessions/REF30/8BLW4RW HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
回應
code language-https 
HTTP/1.1 200 OK

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

{
    "parameters": {
        "existing": {
            "mvpd": "Cablevision",
            "domain": "adobe.com"
            "redirectUrl": "https://www.adobe.com"
        }
}

1.使用遺失的引數擷取驗證工作階段

要求
code language-https 
GET /api/v2/sessions/REF30/8BLW4RW HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
回應
code language-https 
HTTP/1.1 200 OK

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

{
    "parameters": {
        "existing": {
            "mvpd": "Cablevision",
            "domain": "adobe.com"
        },
        "missing": ["redirectUrl"]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b