Перечисленные в этом документе конечные точки были упразднены 24 октября 2020 г. При их использовании будет возвращаться код ошибки 400. Вместо них следует использовать новые конечные точки oEmbed для Facebook.

Старые конечные точки oEmbed для встраиваемого контента Facebook

oEmbed — это открытый формат, предназначенный для встраивания материалов веб-сайта в другие веб-страницы. В частности, он позволяет людям встраивать публикации и видео с Facebook в свои веб-сайты.

URL конечных точек

Запросить код встраивания для общедоступных публикаций и видео можно с помощью конечной точки API. Ответы представлены в формате json. Замените {content-url} на URL публикации или видео.

Тип URL конечной точки

Публикация

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

Видео

https://www.facebook.com/plugins/video/oembed.json/?url={content-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&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-кодировать.

Параметр Описание

url

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.