이 페이지에 설명된 엔드포인트는 2020년 10월 24일에 사용이 중단되었으며, 이제 오류 코드 400을 반환합니다. 대신 새로운 Facebook oEmbed 엔드포인트를 사용하세요.

퍼갈 수 있는 Facebook 콘텐츠용 oEmbed 엔드포인트(기존)

oEmbed는 웹사이트의 콘텐츠를 다른 페이지에 퍼갈 수 있도록 설계된 개방적 형식입니다. Facebook 게시물과 동영상을 웹사이트에 퍼가기 위한 oEmbed 표준을 사용할 수 있습니다.

엔드포인트 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}

참고: Facebook의 플랫폼은 지속적으로 발전하고 있으므로 이 리스트는 완전하지 않을 수 있습니다.

Facebook 개발자 동영상 친구와 공유하는 방법을 퍼가기 위한 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 = \"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.)를 포함하여 응답하도록 합니다.