POST/api/public/consultation

Zentor веб-сайтының ашық кеңес сұрау формасы.

«POST /api/public/consultation — API-сілтемесі» беті URL-де көрсетілген функциялық аймақты қамтиды. Бар мазмұны нақты орындау ретімен, талаптармен және белгілі шектеулермен толықтырылады. Форма құрастырғышы триггерлік кілт сөздері, өріс түрлері және міндетті өрістерді белгілеу арқылы еркін баптауға болатын формаларды қолдайды. Бұл функция E2E-тестілеуден өтті. `POST /api/public/consultation` құжаттамасы осы нақты соңғы нүктенің техникалық сипаттамасы ретінде оқылуы тиіс. Маңыздысы — әдіс, жол, аутентификация, міндетті өрістер, мүмкін болатын қателер және қайталама шақыру сол әсерді тудыра ма деген сұрақ. Сондықтан берілген https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation URL-і жалпы жарнамалық мәлімдемелерді қамтуы мүмкін емес, тек орындалуы мүмкін интеграция қадамдары мен дәлелденген жауап мысалдарын ғана қамтуы керек. `/api/public/consultation` шақыруы үшін сұраныс Registry-ге сәйкес құрастырылады. Ашық маршруттарға жалпы әзірлеуші API кілті қажет емес, себебі Zentor мұндай кілт жүйесін ұсынбайды. Қорғалған виджет маршруттары керісінше, бір рет көрсетілген Embed-токенді және Origin тексеруін қолданады. HTTP статусы мен JSON мазмұны бірлесіп бағалануы тиіс; `ok` өрісі жалғыз қателерді өңдеуді алмастырмайды. `POST /api/public/consultation` тестілеу кезінде анонимдеген мәндерді қолдану қажет. Нақты клиент деректері, өндірістік UUID-тер, сессия токендері және нақты уақыт белгілері ашық мысалдарға жатпауы керек. Платформа деңгейіндегі белгілі шектеу 15 минут ішінде 2.000 сұраныс; бұдан өзгеше жеке шектеу дәлелденбеген. Идентификацияланбаған желі үзілісінен кейін idempotent емес POST шақыруларын соқыр түрде қайталауға болмайды. Бұл маршрут үшін типтік интеграция қателері міндетті параметрлердің жоқтығынан, дұрыс емес деректер типтерінен, мерзімі өткен бір реттік кодтардан, рұқсат етілмеген Origin-дерден немесе алдын ала жоқ деректер жазбасынан туындайды. Қолданба мұндай жағдайларды бөлек өңдеуі және соңғы нүктеден қайтарылған қате хабарламасын жазбасы керек, құпия мазмұнды жазбай. Сәтті сұраныс тек осы өңдеу қадамын растайды, автоматты түрде кешіктірілген электрондық пошта, төлем немесе SSO сәттілігін білдірмейді. Бұл «POST /api/public/consultation» үшін тікелей маңызды. Бұл беттің техникалық тексеруі `app/frontend/src/content/api-reference/` Registry-не және тиісті Backend маршруттарына негізделуі тиіс. Тірі тестілеу туралы ескертулер тек нақты тексерілген нәрсені ғана айта алады. Теріс тест немесе код аналогиясы толық сәттілік нұсқауы емес. POST /api/public/consultation — API-сілтемесі үшін құжатталған құрылым, автоматтандырылған тест және қауіпсіз бақыланатын тірі мінез-құлық арасында анық айырмашылық жасау қажет.

{"name":"Макс Мустерманн","email":"max@example.com","company":"Мустерфирма","message":"Сұраныс","consentGiven":true}

{"ok":true,"message":"Сіздің кеңес сұранысыңыз жіберілді. Біз сізбен жақын арада байланысамыз."}