Endpoint yang didokumentasikan di halaman ini dihentikan tanggal 24 Oktober 2020 dan sekarang mengembalikan kode kesalahan 400. Gunakanlah endpoint oEmbed Facebook baru.

Endpoint oEmbed untuk Konten Facebook yang Dapat Disematkan (Legasi)

oEmbed merupakan format terbuka yang dirancang agar memungkinkan Anda menyematkan konten dari situs web ke halaman lain. Anda dapat menggunakan standar oEmbed untuk menyematkan postingan dan video Facebook ke situs web Anda.

URL Endpoint

Anda dapat menggunakan endpoint API kami untuk meminta kode sematan Postingan dan Video publik, semua tanggapan berformat json. Ganti {content-url} dengan URL postingan atau video Anda:

Jenis URL Endpoint

Postingan

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

Video

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

URL Konten

Postingan dan video Facebook publik dapat menggunakan salah satu skema URL ini:

  • Postingan:
  • 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}

Catatan: Karena platform kami terus berkembang, daftar ini mungkin tidak lengkap.

Contoh

Katakanlah Anda ingin mendapatkan data oEmbed untuk menyematkan video Developer Facebook How to Share With Just Friends, panggil URL endpoint: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

Tanggapan json akan seperti ini:

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

Parameter

Semua parameter harus dikirim dengan enkode URL.

Parameter Deskripsi

url

URL postingan atau video (wajib)

maxwidth

Lebar maksimum sumber daya sematan (opsional). Perhatikan bahwa parameter maxheight tidak didukung. Ini karena kode sematan bersifat responsif dan tingginya bervariasi sesuai lebarnya.

callback

Callback JSON yang akan diminta (opsional)

omitscript

Jika diatur ke true, kode sematan tidak termasuk tanda skrip (opsional)

breaking_change

Atur ke oembed agar endpoint menanggapi dengan kode kesalahan 400 dan pesan: This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint.