GET/api/sso/:tenantSlug/saml/metadata
يُقدّم بيانات تعريف SAML الخاصة بـ Zentor App (XML) لاستيرادها في مزوّد الهوية الخاص بكم.
تحتوي البيانات التعريفية في جملتها على المُعرِّف الفريد (Entity-ID) وعنوان ACS الذي يحتاجه مزوّد الهوية الخاص بكم للإعداد. الاستجابة هي وثيقة XML، لا JSON. إذا لم يكن SAML مُهيَّأ للحساب، يستجيب الخادم بـ404 `SSO_NOT_CONFIGURED`.
نظرة عامة
الاستدعاء: GET /api/sso/:tenantSlug/saml/metadata. تنتمي نقطة النهاية هذه إلى مجموعة «روبوت الدردشة التجريبي وSSO» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء متساوي القوة (idempotent): الاستدعاءات المتكررة بالبيانات نفسها تُرجع النتيجة نفسها. المعاملات الإلزامية: tenantSlug (المسار). حالات الخطأ الموثقة: 404 -.
المصادقة والأمان
لا يلزم أي مصادقة
متطابق القوة: نعم
المعلمات
tenantSlug(path, string، إلزامي)— مُعرِّف (Slug) الحساب الذي يُهيَّأ له SSOمثال استجابة
(بيانات تعريف SAML بصيغة XML، إذا كان SAML مُهيَّأ للحساب — دون JSON)
رموز الأخطاء
404 - — SAML غير مُهيَّأ لهذا الحساب.السلوك المُتحقَّق منه
حساب بلا SAML يُعيد الاستدعاء له 404.
روبوت الدردشة التجريبي وSSO
POST /api/global-chatbot/demoيُرسل رسالة إلى روبوت الدردشة التجريبي العام على zentor-app.de/demo ويُرجع رده. يمكن تجربة العرض التجريبي في المتصفح دون تسجيل.GET /api/global-chatbot/demo/historyيحمّل سجل الرسائل السابق لمحادثة تجريبية، بحيث يبقى محفوظًا عند إعادة فتح العرض التجريبي.POST /api/global-chatbot/demo/pollيستدعي الرسائل الجديدة لمحادثة تجريبية، كما يحدث عند تولّي أحد موظفي Zentor المحادثة. تستدعي صفحة العرض التجريبي هذا المسار على فترات.POST /api/global-chatbot/demo/ratingيحفظ تقييم محادثة تجريبية (مفيدة أو غير مفيدة) مع تعليق اختياري.POST /api/global-chatbot/demo/trackيسجّل أحداث استخدام مجهولة الهوية لصفحة العرض التجريبي لإحصاءات زوار Zentor.POST /api/global-chatbot/demo/voice-transcribeيحوّل تسجيلًا صوتيًا على صفحة العرض التجريبي إلى نص (إدخال صوتي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.POST /api/global-chatbot/demo/voice-speakيحوّل النص إلى كلام منطوق (إخراج صوتي في صفحة العرض التجريبي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.GET /api/sso/:tenantSlug/statusيتحقق مما إذا كان تسجيل الدخول الموحد (SAML أو OIDC) مُهيَّأ لحساب معيّن. تستخدم صفحة تسجيل الدخول النتيجة لعرض خيار الدخول عبر SSO.GET /api/sso/:tenantSlug/oidc/startيبدأ تسجيل الدخول عبر OpenID Connect ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.GET /api/sso/:tenantSlug/oidc/callbackيستقبل تحويل مزوّد الهوية بعد تسجيل الدخول عبر OIDC، ويعيد توجيه المتصفح إلى Zentor App.GET /api/sso/:tenantSlug/saml/startيبدأ تسجيل الدخول عبر SAML ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.POST /api/sso/:tenantSlug/saml/acsخدمة استقبال التأكيد (ACS): تستقبل استجابة SAML الموقَّعة من مزوّد الهوية عبر POST عبر نموذج.