이 페이지에 설명된 엔드포인트는 2020년 10월 24일에 사용이 중단되었으며, 이제 오류 코드 400
을 반환합니다. 대신 새로운 Facebook oEmbed 엔드포인트를 사용하세요.
oEmbed는 웹사이트의 콘텐츠를 다른 페이지에 퍼갈 수 있도록 설계된 개방적 형식입니다. Facebook 게시물과 동영상을 웹사이트에 퍼가기 위한 oEmbed 표준을 사용할 수 있습니다.
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}
참고: 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&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로 설정하면 퍼가기에 스크립트 태그가 포함되지 않습니다(선택 사항). |
|
|