Демо-чатбот және SSO
Жеке тұлғаға арналған демо-чатбот және бір реттік кіру (SSO) нүктелері.
«Demo-чатбот және SSO — API-сілтеме» беті URL-де көрсетілген функциялық аймақты қамтиды. Бар мазмұны нақты жұмыс істеу ретімен, талаптармен және белгілі шектеулермен толықтырылады. Zentor-да әзірлеуші API кілт жүйесі жоқ. Dashboard үшін он екі сағат мерзімі бар сессия JWT-лері және жеті күн мерзімі бар жаңарту токендері қолданылады; TOTP және SSO міндетті емес. Виджетті кірістіру токендері бір рет ашық мәтін түрінде көрсетіледі және рұқсат етілген шығу нүктелеріне байланысты.
`POST /api/global-chatbot/demo` құжаттамасы осы нақты ұшқыштың техникалық сипаттамасы ретінде міндетті түрде қабылдануы керек. Әдіс, жол, аутентификация, міндетті өрістер, мүмкін қателер және қайта шақыру сол әсерді тудыра ма деген сұрақ шешуші рөл атқарады. Бұл көмек бөлімі https://zentor-app.de/hilfe/api-referenz/demo-und-sso жалпы жарнамалық мәлімдемелерді қамтуы мүмкін емес, тек кейінгі дәлелденетін интеграция қадамдары мен расталған жауап мысалдарын қамтуы тиіс.
`/api/global-chatbot/demo` шақыру үшін сұраныс Registry-ге сәйкес құрылады. Ашық жолдар жалпы әзірлеуші API кілтін қажет етпейді, себебі Zentor мұндай кілт жүйесін ұсынбайды. Қорғалған виджет жолдары керісінше бір рет көрсетілген кірістіру токенін және шығу нүктесін тексеруді қолданады. HTTP статусы мен JSON мазмұны бірге бағалануы керек; `ok` өрісі қателерді өңдеуді алмастырмайды.
`POST /api/global-chatbot/demo` тестілеу кезінде анонимдеген мәндерді қолдану қажет. Нақты клиент деректері, өндірістік UUID-лер, сессия токендері мен нақты уақыт белгілері ашық мысалдарға жатпайды. Платформа деңгейіндегі белгілі шектеу 15 минут ішінде 2.000 сұраныс; бұдан өзгеше жеке шектеу дәлелденбеген. Идентификацияланбаған желі үзілісінен кейін идентификаторланбайтын POST шақыруларын соқыр түрде қайталауға болмайды.
Бұл жол үшін типтік интеграция қателері міндетті параметрлердің жоқтығынан, қате деректер типтерінен, мерзімі өткен бір реттік кодтардан, рұқсат етілмеген шығу нүктелерінен немесе іске қосылмаған деректер жазбасынан туындайды. Қолданба мұндай жағдайларды бөлек өңдеуі және ұшқыштан қайтарылған қате хабарламаны жазбасына жазуы керек, құпия мазмұнды қоспастан. Сәтті сұраныс тек осы өңдеу қадамын растайды, соңындағы электрондық пошта, төлем немесе SSO сәттілігін автоматты түрде растамайды.
Бұл беттің техникалық тексеруі міндетті түрде `app/frontend/src/content/api-reference/` Registry-не және сәйкес келетін backend жолдарына негізделуі керек. Тірі тестілеу туралы ескертулер тек нақты тексерілген нәрсені ғана айтуы мүмкін. Теріс тест немесе код аналогиясы толық сәттілік дәлелі болып табылмайды. Demo-чатбот және SSO — API-сілтеме үшін құрылымдық құжаттама, автоматтандырылған тест және қауіпсіз бақыланатын тірі мінез-құлық арасында анық ажырату қажет.