POST/api/public/contact
Zentor веб-сайтының ашық байланыс формасы. Ішкі лид жүйесінде сұраныс жасайды.
`POST /api/public/contact` Zentor веб-сайтының ашық байланыс формасын өңдейді және сұранысты ішкі лид жүйесіне сақтайды. Бұл нүкте Dashboard аутентификациясын талап етпейді және иделопотентті емес. Әрбір сәтті жіберу жаңа лид тудыруы мүмкін. Сондықтан фронтенд бірінші басудан кейін жіберу түймесін бұғаттап, автоматты қайталауларды іске қоспауы керек. Расталған міндетті өрістерге `name`, `email` және `message` жатады. Есім 2-ден 120 таңбаға дейін ұзындықта болуы тиіс, электрондық пошта мекенжайы жарамды форматқа ие болуы керек, ал хабарлама серверлік валидация ережелеріне сәйкес келуі керек. Қосымша өрістер тек нақты схемада көзделген жағдайда ғана жіберілуі мүмкін. Белгісіз мәндерді лидтің ішкі қасиеттерін басқару үшін қолданбау керек. Дұрыс құрылған форма міндетті өрістерді браузерде алдын ала тексереді, бірақ тек осы тексеруге ғана сенбейді. Сервер шешуші рөл атқарады. Валидация қатесі туындаған жағдайда интерфейс тиісті өрісті белгілеп, енгізілген мазмұнды сақтап қалуы керек. Жалпы сәттілік туралы хабарлама тек серверден оң жауап келгеннен кейін ғана пайда болуы тиіс. Байланыс формасы парольдер, API кілттері, виджет токендері, төлем деректері немесе толық клиент деректер базасы үшін қауіпсіз арна болып табылмайды. Пайдаланушылар қолдану жағдайын, қатысты өнімді және қолжетімді бизнес-электрондық пошта мекенжайын көрсетуі керек. Техникалық мәселе туындаған жағдайда Tenant атауы, уақыты, қатысты функция және қайталанатын қадамдар артық жеке деректерді жібермей-ақ көмектеседі. Шыншыл орындалу реттілігі: келуші есім, электрондық пошта және хабарламаны толтырады, мүмкін болса сайттың деректерді қорғау туралы ескертпелерін растайды және форманы жібереді. Сервер деректерді тексереді, лидті жасайды және сәттілік жауабын қайтарады. Егер электрондық пошта жарамсыз болса немесе есім тым қысқа болса, толық лид жасалмайды. Бұл нүкте Tenant жасамайды, пакетті тіркемейді және құрылымдалған өнім конфигурациясын немесе кеңес беру процесін алмастырмайды. Спам мен автоматтандырылған тізбекті сұраныстардан қорғау үшін клиент серверлік қателерді құрметтеп, бірден шексіз циклдерді іске қоспауы керек. Сәтті жауап сервер қабылдауын растағаннан кейін ғана енгізу өрістерін тазартуы тиіс. Жауап келмесе, пайдаланушы мазмұнды сақтап алып, кейіннен реттелген түрде қайта жібере алады. Ішкі тағайындау үшін хабарлама нақты себепті маркетингтік сөз тіркестерін немесе құпиялы қосымшаларсыз қамтуы керек. Анық тақырып пен нақты мәселені сипаттау қосымша сұрақтарды азайтады. Алайда API өзі кепілдік берілген басымдық тағайындамайды және нақты өңдеу мерзімін растамайды.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
name(body, string, erforderlich)— 2–120 таңбаemail(body, string, erforderlich)— Жарамды электрондық пошта мекенжайыmessage(body, string, erforderlich)— 10–3000 таңбаcompany(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, erforderlich)— Шын болуы керек (деректерді қорғауға келісім)Beispiel-Request
{"name":"Макс Мустерманн","email":"max@example.com","message":"Сіздің хабарламаңыз (кемінде 10 таңба).","consentGiven":true}Beispiel-Response
{"ok":true,"message":"Сұранысыңыз жіберілді."}Fehlercodes
400 VALIDATION_ERROR — Міндетті өріс жоқ/жарамсыз немесе деректерді қорғауға келісім жоқ (жеке қателік хабарламалары бар Detail массиві).Live-Test-Nachweis
Сәттілік (200) және теріс жағдай (400, жетіспейтін өрістер, соның ішінде келісімнің жоқтығы) тікелей тексерілді.