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`)

எடுத்துக்காட்டுப் பதில்

{"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) வழங்குகிறது.

சார்ந்த கட்டுரைகள்

உள்நுழைவு மற்றும் ஒருங்கிணைப்பு வழிகளைப் புரிந்துகொள்ளுதல்நீங்கள் எவ்வாறு பாதுகாப்பாக உள்நுழைவது - மற்றும் Zentor App-ஐ உங்கள் அமைப்புகளுடன் இணைக்கும் மூன்று வழிகள்.IP, டொமைன் மற்றும் நாட்டு அணுகல் விதிகளை உருவாக்குதல்உங்கள் சொந்த அணுகல் விதிகளை உருவாக்குதல், சோதனை முறையில் கண்காணித்தல், 24 மணி நேரத்திற்குப் பிறகு செயல்படுத்துதல்.
← டெமோ சாட்பாட் மற்றும் SSO