此页面展示的端点已于 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}

注意:由于我们的平台会不断改进,此列表可能不完整。

示例

假设您想要获取嵌入 Facebook 开发者视频 How to Share With Just Friends(如何只与好友分享)的 oEmbed 数据,可调用以下端点网址: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.