POST/api/public/consultation

Zentor वेबसाइट का सार्वजनिक सलाहकार अनुरोध फॉर्म।

पृष्ठ “POST /api/public/consultation — API संदर्भ” उस कार्यक्षेत्र को कवर करता है जो URL में निर्दिष्ट है। मौजूद सामग्री को वास्तविक प्रवाह, पूर्वशर्तों और ज्ञात सीमाओं के साथ पूरा किया जाएगा। फॉर्म-बिल्डिंग ब्लॉक ट्रिगर कीवर्ड, फ़ील्ड प्रकार और अनिवार्य फ़ील्ड चिह्नन के साथ स्वतंत्र रूप से कॉन्फ़िगर करने योग्य फॉर्मों का समर्थन करता है। इस कार्यक्षेत्र का E2E परीक्षण किया गया है। `POST /api/public/consultation` का दस्तावेजीकरण इस विशिष्ट एंडपॉइंट की एक तकनीकी विवरण के रूप में पढ़ा जाना चाहिए। निर्णायक कारक विधि, पथ, प्रमाणीकरण, अनिवार्य फ़ील्ड, संभावित त्रुटियाँ और यह प्रश्न हैं कि क्या पुनः कॉल समान प्रभाव उत्पन्न करती है। इसलिए, वर्तमान URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation में सामान्य विपणन दावे नहीं होने चाहिए, बल्कि केवल तत्काल एकीकरण चरण और प्रमाणित उत्तर उदाहरण होने चाहिए। `/api/public/consultation` के लिए एक कॉल करने के लिए, अनुरोध रजिस्ट्री के अनुसार बनाया जाना चाहिए। सार्वजनिक राउट को एक सामान्य डेवलपर API कुंजी की आवश्यकता नहीं होती है, क्योंकि Zentor कोई ऐसी कुंजी प्रणाली प्रदान नहीं करता है। इसके विपरीत, सुरक्षित विजेट राउट एक बार दिखाए गए एम्बेड टोकन और एक ओरिजिन जाँच का उपयोग करते हैं। HTTP स्थिति और JSON सामग्री को साथ में मूल्यांकन किया जाना चाहिए; एक `ok` फ़ील्ड अकेले त्रुटि प्रबंधन का विकल्प नहीं है। `POST /api/public/consultation` के परीक्षण में, एनोनिमाइज़्ड मानों का उपयोग किया जाना चाहिए। वास्तविक ग्राहक डेटा, उत्पादन UUIDs, सत्र टोकन और विशिष्ट टाइमस्टैम्प सार्वजनिक उदाहरणों में नहीं होने चाहिए। प्लेटफ़ॉर्म-व्यापी ज्ञात सीमा 15 मिनट के भीतर 2,000 अनुरोधों में है; एक भिन्न व्यक्तिगत सीमा का प्रमाण नहीं है। गैर-आइडेंपोटेंट POST कॉल्स को एक अस्पष्ट नेटवर्क विच्छेदन के बाद अंधाधुंध दोहराया नहीं जाना चाहिए। इस राउट के लिए सामान्य एकीकरण त्रुटियाँ गायब अनिवार्य पैरामीटर, गलत डेटा प्रकार, समाप्त हो चुके एकल-उपयोग कोड, अनुमत नहीं ओरिजिन या पूर्व-अस्तित्व में न होने वाले डेटा रिकॉर्ड के कारण होती हैं। ऐप को ऐसे मामलों को अलग से संभालना चाहिए और एंडपॉइंट द्वारा लौटाई गई त्रुटि संदेश को लॉग करना चाहिए, बिना किसी गोपनीय सामग्री को शामिल किए। एक सफल अनुरोध केवल इस प्रसंस्करण चरण की पुष्टि करता है, न कि स्वचालित रूप से बाद में ईमेल, भुगतान या SSO सफलता की। यह “POST /api/public/consultation” के लिए तुरंत प्रासंगिक है। इस पृष्ठ की तकनीकी जाँच को `app/frontend/src/content/api-reference/` के अंतर्गत रजिस्ट्री और संबंधित बैकएंड राउटों पर दृढ़ता से आधारित होना चाहिए। लाइव-टेस्ट नोट्स केवल वही दावा कर सकते हैं जो वास्तव में परीक्षण किया गया है। एक नकारात्मक परीक्षण या कोड समानता एक पूर्ण सफलता निर्देश नहीं है। इसलिए, POST /api/public/consultation — API संदर्भ के लिए, दस्तावेज़ीकृत संरचना, स्वचालित परीक्षण और सुरक्षित रूप से अवलोकित लाइव व्यवहार के बीच स्पष्ट अंतर करना आवश्यक है।

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2–120 अक्षर
email(body, string, erforderlich)मान्य ईमेल पता
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, erforderlich)सच होना चाहिए

Beispiel-Request

{"name":"मैक्स मुस्टरमैन","email":"max@example.com","company":"मुस्टरफ़र्म","message":"अभियान","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"आपकी सलाह का अनुरोध भेज दिया गया है। हम जल्द ही आपसे संपर्क करेंगे।"}

Fehlercodes

400 VALIDATION_ERRORअनिवार्य फ़ील्ड अनुपस्थित/अमान्य है या सहमति अनुपस्थित है।

Live-Test-Nachweis

सफलता (200) और नकारात्मक मामला (400) लाइव सत्यापित।

सार्वजनिक फॉर्म