Brightcove 聯合發行項目摘要 API 是一個公用 API,可用來擷取使用聯合發行項目設定 API 建立的 MRSS 摘要。
聯合發行項目設定 API 也可以用來擷取摘要,只要將聯合發行項目中syndication_url
傳回的項目開啟至瀏覽器,但摘要 API 不同之處在於它不需要驗證-任何擁有正確 URL 的人都可以擷取摘要。
使用一個或另一個API檢索供稿的主要用例如下:
- 如果只想自己託管供稿,例如對於訂閱者,則可以使用Syndication Configuration API來檢索供稿。
- 如果您有聯合發行合作夥伴希望提供摘要以他們希望的任何方式使用和託管,您可以提供 Feed API URL,以便直
syndication_id
接擷取摘要。
API參考/基本URL
摘要 API 參考包含可用要求和回應的完整詳細資料。
基本網址是:
https://social.feeds.brightcove.com/v1
驗證
對 Feed API 的存取不需要驗證,因為摘要旨在可公開存取。
作業
Feed API只有一項操作:取得根據的摘要syndication_id
。
請求網址
https://social.feeds.brightcove.com/v1/accounts/{account_id}/mrss/syndications/{syndication_id}/feed
方法:得到
查詢參數
所有查詢參數都是可選的。
limit
- 供稿響應中包含的最大項目數。允許範圍為1到100。預設值:100。
offset
- 生成返回的提要時要跳過的項目數。預設值:0。
updated_after
- ISO-8601 日期時間字串 (例如,2016-03-16T15:42:06 .000Z 或
2016-03-16T10:47:29-05:00
),會將摘要結果限制在指定日期之後更新的資產。
請求正文:無
這個很重要!如果包含請求正文,將返回錯誤。
回應類型:XML格式