POST/api/global-chatbot/demo/voice-transcribe

ڈیمو صفحے پر صوتی ریکارڈنگ کو متن میں تبدیل کرتا ہے (صوتی ان پٹ)، بشرطیکہ ڈیمو کی صوتی سہولت فعال ہو۔

`visitor_id` (UUID) اور آڈیو فائل کو `audio` فیلڈ میں `multipart/form-data` کے طور پر بھیجیں۔ جواب میں شناخت شدہ متن شامل ہے۔ یہ اینڈ پوائنٹ `POST /api/public/widget/voice-transcribe` کے مطابق ہے، لیکن zentor-app.de کے ڈیمو سے منسلک ہے۔ خرابیاں: 400 `INVALID_VISITOR_ID` (غائب یا غلط UUID)، 403 `ORIGIN_DENIED` (zentor-app.de سے کال نہیں)، 413 `AUDIO_TOO_LARGE` (فائل بہت بڑی) اور 415 `AUDIO_TYPE_UNSUPPORTED` (فارمیٹ سپورٹ نہیں)۔

جائزہ

کال: POST /api/global-chatbot/demo/voice-transcribe۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “ڈیمو چیٹ بوٹ اور SSO” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: visitor_id (باڈی), audio (باڈی)۔ دستاویزی ایرر کیسز: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

صرف https://zentor-app.de اور https://www.zentor-app.de سے کالز قبول کرتا ہے؛ ڈیمو کے لیے ایمبیڈ ٹوکن ضروری نہیں۔

Idempotent (دہرانے پر یکساں اثر): نہیں

پیرامیٹرز

visitor_id(body, string، ضروری)— وزیٹر آئی ڈی، درست UUID ہونا چاہیے
audio(body, file، ضروری)— آڈیو فائل (`multipart/form-data`)

مثالی Response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id کو ایک درست UUID ہونا چاہیے۔"}}

خرابی کے کوڈز

400 INVALID_VISITOR_ID — `visitor_id` غائب ہے یا درست UUID نہیں ہے۔
403 ORIGIN_DENIED — کال zentor-app.de سے نہیں ہے۔
413 AUDIO_TOO_LARGE — آڈیو فائل جائز سائز سے زیادہ ہے۔
415 AUDIO_TYPE_UNSUPPORTED — آڈیو فارمیٹ سپورٹ نہیں ہے۔

تصدیق شدہ طرزِ عمل

غلط `visitor_id` 400 `INVALID_VISITOR_ID` واپس کرتا ہے، اور دوسرے ڈومین سے کال 403 `ORIGIN_DENIED` واپس کرتی ہے۔ کامیابی صرف zentor-app.de سے ممکن ہے۔

ڈیمو چیٹ بوٹ اور SSO

POST /api/global-chatbot/demozentor-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/trackZentor کے وزیٹر اعداد و شمار کے لیے ڈیمو صفحے کے گمنام استعمال کے واقعات ریکارڈ کرتا ہے۔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) فراہم کرتا ہے۔

متعلقہ مضامین

← ڈیمو چیٹ بوٹ اور SSO