포함(embed) 가능한 Facebook 콘텐츠의 oEmbed 엔드포인트

oEmbed는 웹사이트에서 다른 페이지로 콘텐츠를 포함할 수 있도록 디자인된 개방형 형식입니다. Facebook 게시물과 동영상을 웹사이트에 포함시키려면 oEmbed 표준을 사용할 수 있습니다.

엔드포인트 URL

API 엔드포인트를 사용하여 전체 공개 게시물동영상의 포함(embed) 코드를 요청할 수 있습니다. 모든 응답은 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}

참고: Facebook에서는 플랫폼을 지속적으로 개선하고 있으므로 이 리스트는 최종 버전이 아닐 수 있습니다.

Facebook 개발자 동영상 How to Share With Just Friends(친구와 공유하는 방법)를 포함하기 위해 oEmbed 데이터를 가져오려는 경우 다음 엔드포인트 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 = \"//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

포함(embed)된 리소스의 최대 너비(선택 사항) maxheight 매개변수는 지원되지 않습니다. 포함(embed)된 코드가 반응형이며 높이가 너비에 따라 달라지기 때문입니다.

callback

호출될 JSON 콜백(선택 사항)

omitscript

true로 설정되면 포함(embed)된 코드에 스크립트 태그가 포함되지 않습니다(선택 사항)