Перечисленные в этом документе конечные точки были упразднены 24 октября 2020 г. При их использовании будет возвращаться код ошибки 400
. Вместо них следует использовать новые конечные точки oEmbed для Facebook.
oEmbed — это открытый формат, предназначенный для встраивания материалов веб-сайта в другие веб-страницы. В частности, он позволяет людям встраивать публикации и видео с Facebook в свои веб-сайты.
Запросить код встраивания для общедоступных публикаций и видео можно с помощью конечной точки API. Ответы представлены в формате json
. Замените {content-url}
на URL публикации или видео.
Тип | URL конечной точки |
---|---|
Публикация |
|
Видео |
|
Общедоступные публикации и видео на Facebook следуют одной из перечисленных ниже схем URL.
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 for Developers How to Share With Just Friends (Как поделиться только с друзьями). Для этого выполните вызов к URL конечной точки: 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%" }
Перед отправкой все параметры следует URL-кодировать.
Параметр | Описание |
---|---|
| URL публикации или видео (обязательно) |
| Максимальная ширина встраиваемого контента (необязательно). Обратите внимание: параметр |
| Обратный вызов JSON (необязательно) |
| Если установлено значение true, в коде встраивания не включена метка скрипта (необязательно). |
| Установите значение |