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` کی کال کے لیے درخواست Registry کے مطابق بنائی جاتی ہے۔ عوامی روٹس کو عمومی Developer-API-Key کی ضرورت نہیں، کیونکہ Zentor ایسا کوئی کلیدی نظام پیش نہیں کرتا۔ اس کے برعکس محفوظ Widget-روٹس ایک بار دکھایا جانے والا Embed-Token اور Origin چیک استعمال کرتے ہیں۔ HTTP اسٹیٹس اور JSON مواد کو ساتھ ساتھ دیکھنا ضروری ہے؛ صرف `ok` فیلڈ غلطی کی ہینڈلنگ کا متبادل نہیں۔ `POST /api/public/consultation` کی جانچ میں گمنام کیے گئے ویلیوز استعمال کیے جائیں۔ حقیقی کسٹمر ڈیٹا، پروڈکشن UUIDs، سیشن ٹوکنز اور ٹھوس ٹائم اسٹیمپس عوامی مثالوں میں شامل نہیں ہونے چاہییں۔ معلوم پلیٹ فارم گیر حد 15 منٹ میں 2,000 درخواستیں ہے؛ کوئی مختلف انفرادی حد ثابت نہیں۔ غیر idempotent POST کالز کو غیر واضح نیٹ ورک انقطاع کے بعد اندھا دھند دہرایا نہیں جانا چاہیے۔ اس روٹ کی عام انٹیگریشن غلطیاں غائب لازمی پیرامیٹرز، غلط ڈیٹا ٹائپس، میعاد ختم ہونے والے ایک بار کے کوڈز، غیر مجاز Origins یا پہلے سے موجود نہ ہونے والے ریکارڈ کی وجہ سے پیدا ہوتی ہیں۔ ایپلیکیشن کو ایسی صورتوں کو الگ الگ سنبھالنا چاہیے اور اینڈ پوائنٹ کی واپس کردہ غلطی کا پیغام لاگ کرنا چاہیے، بغیر خفیہ مواد ساتھ لکھے۔ کامیاب درخواست صرف اسی پروسیسنگ مرحلے کی تصدیق کرتی ہے، خودکار طور پر کسی بعد کے ای میل، ادائیگی یا SSO کامیابی کی نہیں۔ یہ «POST /api/public/consultation» کے لیے براہ راست متعلقہ ہے۔ اس صفحے کی تکنیکی جانچ کو لازماً `app/frontend/src/content/api-reference/` کے تحت Registry اور متعلقہ بیک اینڈ روٹس پر مبنی ہونا چاہیے۔ لائیو ٹیسٹ نوٹس صرف وہی دعویٰ کر سکتے ہیں جو واقعی جانچا گیا ہو۔ منفی ٹیسٹ یا کوڈ سے مشابہت مکمل کامیابی کا ثبوت نہیں۔ POST /api/public/consultation — API-ریفرنس کے لیے اس لیے دستاویزی ساخت، خودکار ٹیسٹ اور محفوظ طور پر مشاہدہ کیے گئے لائیو رویے کے درمیان واضح فرق کیا جانا چاہیے۔

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"مسئلہ","consentGiven":true}

{"ok":true,"message":"آپ کی مشورے کی درخواست جمع کر دی گئی ہے۔ ہم جلد ہی آپ سے رابطہ کریں گے۔"}