GET/api/global-chatbot/demo/history
ایک ڈیمو گفتگو کی سابقہ پیغامات کی تاریخ لوڈ کرتا ہے، تاکہ ڈیمو دوبارہ کھولنے پر یہ محفوظ رہے۔
`session_id` اور `visitor_id` کوئری پیرامیٹرز کے طور پر بھیجیں؛ دونوں ایک ہی ڈیمو گفتگو سے ہونے چاہئیں۔ جواب میں `data` آبجیکٹ میں `id`، `role`، `text` اور `created_at` کے ساتھ فہرست `messages` شامل ہے۔ یہ کال صرف پڑھنے کے لیے اور idempotent ہے۔ اگر کوئی پیرامیٹر غائب ہو تو سرور 400 `PARAMS_REQUIRED` کے ساتھ جواب دیتا ہے۔ اگر سیشن معلوم نہ ہو تو نئی ڈیمو گفتگو شروع کریں۔
جائزہ
کال: GET /api/global-chatbot/demo/history۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “ڈیمو چیٹ بوٹ اور SSO” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent ہے: ایک جیسی معلومات کے ساتھ بار بار کال کرنے پر ایک ہی نتیجہ ملتا ہے۔ لازمی پیرامیٹرز: session_id (کوئری), visitor_id (کوئری)۔ دستاویزی ایرر کیسز: 400 PARAMS_REQUIRED۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔
تصدیقِ شناخت اور تحفظ
تصدیقِ شناخت ضروری نہیں
Idempotent (دہرانے پر یکساں اثر): جی ہاں
پیرامیٹرز
session_id(query, string، ضروری)— ڈیمو گفتگو کی سیشن آئی ڈیvisitor_id(query, string، ضروری)— وزیٹر آئی ڈی (UUID) جو ڈیمو صفحہ بناتا ہےمثالی Response
{"ok": true, "data": {"messages": [{"id": "f248d929-c9ce-412d-aba8-43808ca1c9f7", "role": "user", "text": "سلام، Zentor کی قیمت کیا ہے؟", "created_at": "2026-07-20T17:07:02.240Z"}, {"id": "3c26b6a6-4ca6-47a9-9669-a052082007ac", "role": "assistant", "text": "میں آپ کو دکھا سکتا ہوں کہ یہ آپ کے استعمال کے لیے کیسے نظر آئے گا — کسی پابندی کے بغیر۔", "created_at": "2026-07-20T17:07:02.329Z"}]}}خرابی کے کوڈز
400 PARAMS_REQUIRED — `session_id` یا `visitor_id` غائب ہے۔تصدیق شدہ طرزِ عمل
موجودہ ڈیمو سیشن 200 کے ساتھ تاریخ واپس کرتا ہے؛ غائب پیرامیٹرز 400 `PARAMS_REQUIRED` واپس کرتے ہیں۔
ڈیمو چیٹ بوٹ اور SSO
POST /api/global-chatbot/demozentor-app.de/demo پر عوامی ڈیمو چیٹ بوٹ کو پیغام بھیجتا ہے اور اس کا جواب واپس کرتا ہے۔ ڈیمو کو بغیر رجسٹریشن کے براؤزر میں آزمایا جا سکتا ہے۔POST /api/global-chatbot/demo/pollایک ڈیمو گفتگو کے نئے پیغامات حاصل کرتا ہے، مثلاً جب Zentor کا کوئی رکن گفتگو سنبھال لے۔ ڈیمو صفحہ اس اینڈ پوائنٹ کو وقفوں سے کال کرتا ہے۔POST /api/global-chatbot/demo/ratingایک ڈیمو گفتگو کی درجہ بندی (مفید یا غیر مفید) اختیاری تبصرے کے ساتھ محفوظ کرتا ہے۔POST /api/global-chatbot/demo/trackZentor کے وزیٹر اعداد و شمار کے لیے ڈیمو صفحے کے گمنام استعمال کے واقعات ریکارڈ کرتا ہے۔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/startOpenID Connect کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔GET /api/sso/:tenantSlug/oidc/callbackOIDC لاگ ان کے بعد شناختی فراہم کنندہ کی ری ڈائریکٹ وصول کرتا ہے اور براؤزر کو Zentor App کی طرف واپس بھیجتا ہے۔GET /api/sso/:tenantSlug/saml/startSAML کے ذریعے لاگ ان شروع کرتا ہے اور براؤزر کو ترتیب شدہ شناختی فراہم کنندہ کی طرف بھیجتا ہے۔POST /api/sso/:tenantSlug/saml/acsاسرشن کنزیومر سروس (ACS): شناختی فراہم کنندہ کا دستخط شدہ SAML جواب فارم POST کے ذریعے وصول کرتا ہے۔GET /api/sso/:tenantSlug/saml/metadataآپ کے شناختی فراہم کنندہ میں درآمد کرنے کے لیے Zentor App کا SAML میٹا ڈیٹا (XML) فراہم کرتا ہے۔