擷取授權Token retrieve-authorization-token

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
驗證

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) Token。

端點

呼叫
者

輸入
引數

HTTP
方法

回應

HTTP
回應

<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 （已棄用）

GET

1.成功
2。驗證Token
找不到或已過期：
XML說明原因
找不到authn權杖的
3。授權權杖
找不到：
XML說明
4。授權權杖
已過期：
XML說明

200 — 成功
412 — 無AuthN

404 — 無AuthZ

410 - AuthZ已過期

輸入引數

說明

要求者

此作業有效的程式設計師要求者ID。

deviceId

裝置識別碼位元組。

resource

包含resourceId （或MRSS片段）的字串，可識別使用者要求的內容並由MVPD授權端點識別。

device_info/

X-Device-Info

串流裝置資訊。

注意：這可以作為URL引數傳遞device_info，但由於此引數的潛在大小以及GETURL長度的限制，它應該作為X-Device-Info傳遞到http標頭。

檢視傳遞裝置和連線資訊中的完整詳細資料。

deviceType

裝置型別（例如Roku、PC）。

若此引數設定正確，ESM提供的量度在使用Clienless時，會針對每個裝置型別🔗進行劃分，因此可以執行不同型別的分析，例如Roku、AppleTV和Xbox。

檢視，在傳遞量度中使用無使用者端裝置型別引數的好處

注意： device_info將會取代此引數。

deviceUser

裝置使用者識別碼。

appId

應用程式id/名稱。

注意： 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
    }

找不到授權Token：

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