此頁面所列的端點已於 2020 年 10 月 24 日停用,現在會傳回錯誤代碼 400。請改用全新 Facebook oEmbed 端點

適用於可內嵌 Facebook 內容的 oEmbed 端點(舊版)

oEmbed 是一種開放格式,用於將某個網站的內容嵌入至其他網頁。您可使用 oEmbed 標準,在網站中嵌入 Facebook 帖子和影片。

端點網址

您可使用 API 端點來要求獲取公開帖子影片的內嵌程式碼,且所有回覆將採用 json 格式。將 {content-url} 替換為您的帖子或影片網址:

類型 端點網址

帖子

https://www.facebook.com/plugins/post/oembed.json/?url={content-url}

影片

https://www.facebook.com/plugins/video/oembed.json/?url={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&amp;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%"
}

參數

所有參數均需經過網址編碼處理方可傳送。

參數 說明

url

帖子或影片網址(必填)

maxwidth

內嵌資源的闊度上限(選填)。請注意,系統不支援 maxheight 參數。這是因為內嵌程式碼屬回應性質,其高度會視乎闊度而改變。

callback

想觸發的 JSON 回呼(選填)

omitscript

如果設定為 true,內嵌程式碼就不包含指令碼標籤(選填)

breaking_change

將其設定為 oembed 可讓端點在回應中傳回錯誤代碼 400 和以下訊息:This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint.