Kể từ ngày 24/10/2020, các điểm cuối nêu trên trang này đã ngừng hoạt động và hiện trả về mã lỗi 400. Vui lòng sử dụng các điểm cuối Facebook oEmbed mới.

Các điểm cuối oEmbed dành cho nội dung có thể nhúng trên Facebook (cũ)

oEmbed là định dạng mở được thiết kế nhằm cho phép nhúng nội dung từ trang web vào một trang khác. Bạn có thể sử dụng tiêu chuẩn oEmbed để nhúng bài viết và video trên Facebook vào trang web của mình.

URL điểm cuối

Bạn có thể sử dụng điểm cuối API của chúng tôi để yêu cầu mã nhúng cho Bài viếtVideo công khai, tất cả phản hồi đều ở định dạng json. Hãy thay thế {content-url} bằng URL bài viết hoặc video của bạn:

Loại URL điểm cuối

Bài viết

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

Video

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

URL nội dung

Bài viết và video công khai trên Facebook có thể sử dụng một trong những giao thức URL sau:

  • Bài viết:
  • 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}
  • Video:
  • 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}

Lưu ý: Do nền tảng của chúng tôi liên tục phát triển, danh sách này có thể chưa đầy đủ.

Ví dụ

Giả sử bạn muốn lấy dữ liệu oEmbed để nhúng video dành cho Nhà phát triển trên Facebook có tiêu đề Cách để chỉ chia sẻ với bạn bè, hãy gọi URL điểm cuối sau: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

Phản hồi json sẽ có dạng sau:

{
  "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%"
}

Thông số

Tất cả thông số đều phải được mã hóa URL.

Thông số Mô tả

url

URL của bài viết hoặc video (bắt buộc)

maxwidth

Chiều rộng tối đa của tài nguyên được nhúng (không bắt buộc). Lưu ý rằng thông số maxheight không được hỗ trợ. Nguyên nhân là do mã nhúng dễ thích ứng và chiều cao của mã sẽ khác nhau tùy theo chiều rộng.

callback

Lệnh gọi lại JSON sẽ được gọi (không bắt buộc)

omitscript

Nếu đặt thành true, mã nhúng sẽ không bao gồm thẻ tập lệnh (không bắt buộc)

breaking_change

Đặt thành oembed để yêu cầu điểm cuối phản hồi bằng mã lỗi 400 và thông báo: This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint.