概述：社交 API

本主題概述了社交API。

簡介

社交API可讓您獲取視頻的社交共享狀態和歷史記錄。它主要用於幫助CMS集成，以允許您的用戶在自己的CMS系統中查看此信息。

有關請求的完整詳細信息，請參見API參考。

API 的基本網址是：

  https://edge.social.api.brightcove.com/v1

要求的驗證需要Authorization header：

        Authorization: Bearer {access_token}

這access_token是一個臨時的 OAuth2 訪問令牌，必須從Brightcove OAuth服務中獲取。有關如何獲取客戶端憑據以及如何使用它們來檢索訪問令牌的詳細信息，請參閱Brightcove OAuth概述話題。

當您要求用戶端認證時，您必須指定您想要的帳戶存取或作業類型。以下是當前支持的操作列表Social API：

請注意，儘管社交API處於測試版中，但其權限為不可在Studio Admin部分中獲取，用於管理API憑據。相反，您將必須使用OAuth API創建憑據。但是，Brightcove學習服務已創建了一個簡單的在線工具為此。

在當前版本的API中，僅GET支持請求。有兩類請求，以下幾節概述。

狀態要求返回視頻的當前社交共享狀態。您可以獲取帳戶中所有視頻或特定視頻的狀態。

歷史記錄請求返回視頻的社交共享歷史記錄。您可以獲取帳戶中所有視頻或特定視頻的歷史記錄。