Points de terminaison oEmbed pour le contenu Facebook intégrable

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 vidéos Facebook dans votre site web.

URL de point de terminaison

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

Type URL de point de terminaison

Publication

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

Vidéo

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

URL de contenu

Les publications et les vidéos Facebook publiques peuvent utiliser l’un de ces modèles d’URL :

  • 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 : puisque notre plate-forme est en constante évolution, il est possible que cette liste ne soit pas complète.

Exemple

Imaginons que vous souhaitiez obtenir les données oEmbed pour intégrer la vidéo pour développeurs Facebook Comment partager du contenu uniquement avec ses amis. Vous devez appeler l’URL de point de terminaison : https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

La réponse json ressemble alors à ceci :

{
  "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 = \"//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 encodés sous forme d’URL.

Paramètre Description

url

L’URL de la publication ou de la vidéo (requis).

maxwidth

La largeur maximum de la ressource intégrée (facultatif). Notez que le paramètre maxheight n’est pas pris en charge. En effet, le code d’intégration réagit et sa hauteur varie en fonction de sa largeur.

callback

Un rappel JSON à invoquer (facultatif)

omitscript

S’il est défini sur true, le code d’intégration n’inclut pas la balise de script (facultatif)