此页面展示的端点已于 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}
注意:由于我们的平台会不断改进,此列表可能不完整。
假设您想要获取嵌入 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&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,嵌入代码将不包含脚本标签(可选) |
| 将此参数设置为 |