Points de terminaison oEmbed pour les contenus Facebook intégrables (anciens)

oEmbed est un format ouvert conçu pour vous permettre d’intégrer le contenu d’un site web dans une autre page. Vous pouvez utiliser la norme oEmbed pour intégrer des publications et des vidéos Facebook dans votre site web.

URL des points de terminaison

Vous pouvez utiliser le point de terminaison de notre API pour demander le code d’intégration de publications et de vidéos publiques. Toutes les réponses seront au format json. Remplacez {content-url} par l’URL de votre publication ou vidéo :

URL des contenus

Les publications et vidéos Facebook publiques peuvent utiliser l’un des schémas d’URL suivants :

• Publications :
• 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}
• Vidéos :
• 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}

Remarque : étant donné que notre plateforme évolue constamment, il se peut que cette liste ne soit pas exhaustive.

Exemple

Supposons que vous souhaitiez récupérer les données oEmbed permettant d’intégrer la vidéo Facebook for Developers How to Share With Just Friends (Comment partager du contenu uniquement avec ses amis). Pour ce faire, appelez l’URL de point de terminaison suivante : https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

La réponse json se présente comme suit :

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

Paramètres

Tous les paramètres doivent être envoyés encodés au format URL.