وثائق المطوّرين

oEmbed PersonWise

حوّل دورة عامة من PersonWise URL إلى مشغل تفاعلي صوتي متجاوب دون أن تطلب من المؤلفين لصق رموز iframeHTML.

نقطة النهاية

أرسل طلباً من نوع HTTPGET. وتنسيق الاستجابة المدعوم هو JSON ؛ حيث يُشترط وجود عنوان url ، بينما يُعتبر maxwidth و maxheight قيوداً اختيارية بالبكسل الموجب.

https://personwise.ai/api/oembed

نظام URL المدعوم

https://personwise.ai/t/*/public

يتم حل صفحات الدورات العامة المرتبطة فقط عبر الروابط. أما الدورات الخاصة أو المنسحبة أو غير المتاحة أو غير المعروفة فتردّ برسالة «غير موجودة».

مثال على الطلب

https://personwise.ai/api/oembed?url=https%3A%2F%2Fpersonwise.ai%2Ft%2F1646a8a8%2Fpublic&format=json&maxwidth=800

مثال على الرد

{
  "version": "1.0",
  "type": "rich",
  "provider_name": "PersonWise",
  "title": "Example interactive course",
  "width": 800,
  "height": 450,
  "html": "<iframe src=\"https://personwise.ai/embed/1646a8a8\" ...></iframe>"
}

سلوك المزوّد

  • يحلّل نقطة النهاية روابط دورات PersonWise فقط ولا تستجلب أبداً الأصل الذي قدّمه المتصل.
  • تحافظ التمثيلات على نسبة العرض 16:9 وتلتزم بقيود maxwidth و maxheight.
  • يطلب إطار iframe إذنَي الميكروفون والتشغيل التلقائي؛ أما المضيفون الذين يزيلون هذين الإذنين فيحصلون على بديل مضمن في المشغل.
  • تعلّن صفحات الدورات المحلّلة عن نقطة النهاية باستخدام بيانات الاكتشاف metadata من النوع application/json+oembed.