تم إيقاف استخدام نقاط النهاية الموجودة في هذه الصفحة اعتبارًا من 24 أكتوبر 2020 وتؤدي الآن على إرجاع رمز الخطأ 400. يُرجى استخدام نقاط نهاية oEmbed الجديدة من فيسبوك بدلاً من ذلك.

نقاط نهاية oEmbed لمحتوى فيسبوك القابل للتضمين (قديم)

oEmbed هو تنسيق مفتوح مُصمم خصيصًا للسماح بتضمين المحتوى من أي موقع ويب في صفحة أخرى. يمكنك استخدام معيار oEmbed لتضمين منشورات ومقاطع فيديو من فيسبوك في موقعك على الويب.

عناوين URL لنقطة النهاية

يمكنك استخدام نقطة نهاية API لطلب رمز التضمين للمنشورات ومقاطع الفيديو العامة، وتكون كل الاستجابات بتنسيق json. استبدل {content-url} بواسطة عنوان url للمنشور أو الفيديو لديك:

النوع عنوان URL لنقطة النهاية

المنشور

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

الفيديو

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

عناوين URL للمحتوى

يمكن للمنشورات ومقاطع الفيديو العامة على فيسبوك استخدام أي من مخططات عناوين 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}

ملاحظة: نظرًا لأن منصتنا تتطور باستمرار، فقد لا تكون هذه القائمة كاملة.

المثال

لنفترض أنك تريد الحصول على بيانات 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&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%"
}

المعلمات

يجب إرسال جميع المعلمات في صورة عنوان URL مشفر.

المعلمة الوصف

url

عنوان URL للمنشور أو الفيديو (مطلوب)

maxwidth

أقصى عرض للمورد الذي تم تضمينه (اختياري). يُرجى ملاحظة أن المعلمة maxheight غير مدعومة. وذلك بسبب أن رمز التضمين يعتبر من رموز الاستجابة ويختلف ارتفاعه تبعًا لاختلاف عرضه.

callback

استجابة JSON المطلوب استدعاؤها (اختياري)

omitscript

إذا تم التعيين على true، فلن يحتوي التضمين على إشارة البرنامج النصي (اختياري)

breaking_change

يمكنك التعيين على oembed للحصول استجابة نقطة النهاية التي تتضمن رمز الخطأ 400 والرسالة: This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint.