決定 decisions

決策是由Adobe Pass驗證REST API V2根據使用者的MVPD授權或預先授權查詢而產生，以判斷對受保護內容的存取權是否被授與或拒絕。

根據叫用的API，提供兩種型別的決策：

預先授權決定 preauthorization-decisions

預先授權決定是資訊性的決定，可讓使用者端應用程式被告知MVPD是否允許或拒絕使用者存取受保護的資源。

預先授權（預檢授權）的目的是讓應用程式能夠顯示使用者可能符合檢視資格之內容的精確資訊。 這是透過使用指示器（例如已鎖定或未鎖定的圖示）增強使用者介面以反映存取狀態來達成。

預先授權API的使用並非強制性，如果使用者端應用程式想要在不進行任何篩選的情況下呈現資源目錄，則可略過此步驟。

如果使用者端應用程式打算使用此功能，請務必注意，每個API請求只能針對有限數量的資源取得預先授權決定，通常最多5個。

MVPD可透過各種機制支援預先授權，每種機制對效能以及單一API請求中可處理的最大資源數量都有不同的影響。

如需有關支援預先授權的現有機制的詳細資訊，請參閱MVPD預檢授權檔案。

授權決定 authorization-decisions

授權決定是授權決定，可讓使用者端應用程式符合MVPD的決定，允許或拒絕使用者存取受保護的資源。

授權的目的是讓應用程式在使用MVPD進行許可權驗證並從Adobe Pass驗證收到媒體權杖後，播放使用者要求的資源。

授權API的使用是強制性的，如果客戶端應用程式想要播放使用者請求的資源，則無法跳過此階段，因為它需要在釋放資料流之前向MVPD驗證使用者是否有權使用。

請務必注意，每個API請求只能針對有限數量的資源取得授權決策，通常為1。

授權存留時間(TTL)管理 authorization-ttl-management

授權存留時間(TTL)定義資源在需要重新授權前保持授權狀態的時間。 此時間範圍是有限的，必須與MVPD代表商定。 TTL值可能因以下因素而異：

授權(authZ) TTL可由您的組織管理員或代表您行事的Adobe Pass驗證代表透過Adobe Pass TVE控制面板檢視及變更。

如需詳細資訊，請參閱TVE儀表板整合使用手冊檔案。

受保護的資源 protected-resources

受保護的資源是指可流程化的內容，由MVPD與參與程式設計人員之間的協定所定義的唯一值所識別。

受保護的資源遵循階層式樹狀結構，每個層級提供更精細的內容授權粒度：

資源識別碼 resource-identifier

資源唯一識別碼可以有兩種格式：

在簡單資源識別碼，例如「REF30」（假設代表管道）的情況下，可以將其轉譯為RSS資源識別碼，如下所示：

    <rss version="2.0">
        <channel>
            <title>REF30</title>
        </channel>
    </rss>

在較複雜的資源識別碼的情況下，RSS資源識別碼可以包含其他評等資訊，如下所示：

    <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
        <channel>
            <title>REF30</title>
            <media:rating scheme="urn:mpaa">pg</media:rating>
        </channel>
    </rss>

唯一識別碼對Adobe Pass驗證而言主要是不透明的，但可根據MVPD的功能和需求套用轉換器。 如果MVPD無法辨識或剖析資源識別碼，則會傳回錯誤給Adobe Pass驗證，接著會使用增強錯誤碼將錯誤轉送給使用者端應用程式。

REST API V2 rest-api-v2

可以使用以下API擷取預先授權決定：

可以使用以下API來擷取授權決定：

請參閱上述API的​ 回應 ​和​ 範例 ​區段，瞭解預先授權和授權決定的結構。

如需如何及何時整合上述API的詳細資訊，請參閱下列檔案：