此頁面所列的端點已於 2020 年 10 月 24 日停用,現在會傳回錯誤代碼 400
。請改用全新 Facebook oEmbed 端點。
oEmbed 是一種開放格式,用於將某個網站的內容嵌入至其他網頁。您可使用 oEmbed 標準,在網站中嵌入 Facebook 帖子和影片。
您可使用 API 端點來要求獲取公開帖子和影片的內嵌程式碼,且所有回覆將採用 json
格式。將 {content-url}
替換為您的帖子或影片網址:
類型 | 端點網址 |
---|---|
帖子 |
|
影片 |
|
公開 Facebook 帖子和影片可使用下列其中一項網址配置:
https://www.facebook.com/
{page-name}
/posts/
{post-id}
https://www.facebook.com/
{username}
/posts/
{post-id}
https://www.facebook.com/
{username}
/activity/
{activity-id}
https://www.facebook.com/photo.php?fbid=
{photo-id}
https://www.facebook.com/photos/
{photo-id}
https://www.facebook.com/permalink.php?story_fbid=
{post-id}
https://www.facebook.com/media/set?set=
{set-id}
https://www.facebook.com/questions/
{question-id}
https://www.facebook.com/notes/
{username}
/
{note-url}
/
{note-id}
https://www.facebook.com/
{page-name}
/videos/
{video-id}
/
https://www.facebook.com/
{username}
/videos/
{video-id}
/
https://www.facebook.com/video.php?id=
{video-id}
https://www.facebook.com/video.php?v=
{video-id}
備註:由於我們會持續改進平台,因此這份清單未必完整。
假設您想獲取 oEmbed 數據,以用於嵌入 Facebook 開發人員影片「如何只與朋友分享」,請呼叫端點網址:https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F
json
回應如下所示:
{ "author_name": "Facebook", "author_url": "https://www.facebook.com/facebook/", "provider_url": "https://www.facebook.com", "provider_name": "Facebook", "success": true, "height": null, "html": "<div id=\"fb-root\"></div>\n<script>(function(d, s, id) {\n var js, fjs = d.getElementsByTagName(s)[0];\n if (d.getElementById(id)) return;\n js = d.createElement(s); js.id = id;\n js.src = \"https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.9\";\n fjs.parentNode.insertBefore(js, fjs);\n}(document, 'script', 'facebook-jssdk'));</script><div class=\"fb-video\" data-href=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><div class=\"fb-xfbml-parse-ignore\"><blockquote cite=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><a href=\"https://www.facebook.com/facebook/videos/10153231379946729/\">How to Share With Just Friends</a><p>How to share with just friends.</p>Posted by <a href=\"https://www.facebook.com/facebook/\">Facebook</a> on Friday, December 5, 2014</blockquote></div></div>", "type": "video", "version": "1.0", "url": "https://www.facebook.com/facebook/videos/10153231379946729/", "width": "100%" }
所有參數均需經過網址編碼處理方可傳送。
參數 | 說明 |
---|---|
| 帖子或影片網址(必填) |
| 內嵌資源的闊度上限(選填)。請注意,系統不支援 |
| 想觸發的 JSON 回呼(選填) |
| 如果設定為 true,內嵌程式碼就不包含指令碼標籤(選填) |
| 將其設定為 |