POST/api/public/consultation

فرم عمومی درخواست مشاوره وب‌سایت Zentor.

صفحه "POST /api/public/consultation — مرجع API" به بخش عملکردی مشخص شده در URL اشاره دارد. محتوای موجود با جزئیات مربوط به جریان کار، پیش‌نیازها و محدودیت‌های شناخته شده تکمیل شده است. ابزار ساخت فرم از فرم‌های قابل تنظیم با کلمات کلیدی، انواع فیلد و علامت‌گذاری فیلدهای اجباری پشتیبانی می‌کند. این قابلیت به طور کامل تست شده است. مستندات مربوط به `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`، باید از مقادیر ناشناس استفاده شود. داده‌های واقعی مشتری، UUIDهای فعال، توکن‌های نشست و زمان‌بندی‌های خاص نباید در نمونه‌های عمومی قرار گیرند. محدودیت کلی پلتفرمی شناخته شده 2000 درخواست در 15 دقیقه است؛ یک محدودیت واحد متفاوت ثابت نشده است. فراخوانی‌های POST غیرقابل تکرار نباید پس از قطع ارتباط شبکه نامشخص، به طور کورکورانه تکرار شوند. خطاهای یکپارچه‌سازی معمول برای این مسیر ناشی از پارامترهای اجباری از دست رفته، انواع داده نادرست، کدهای یک‌بار مصرف منقضی شده، مبداهای غیرمجاز یا عدم وجود مجموعه داده از قبل است. برنامه باید این موارد را به طور جداگانه مدیریت کرده و پیام خطایی را که از نقطه پایانی برگردانده می‌شود، ثبت کند، بدون اینکه محتوای حساس را ثبت کند. یک درخواست موفق فقط این مرحله پردازش را تأیید می‌کند، نه به طور خودکار موفقیت یک ایمیل، پرداخت یا SSO. این موضوع برای "POST /api/public/consultation" کاملاً مرتبط است. بررسی فنی این صفحه باید به طور قطعی بر اساس رجیستری موجود در `app/frontend/src/content/api-reference/` و مسیرهای بک‌اند مربوطه باشد. یادداشت‌های تست زنده فقط باید ادعاهایی را مطرح کنند که واقعاً بررسی شده‌اند. یک تست منفی یا یک آنالیز کد، یک موفقیت کامل محسوب نمی‌شود. بنابراین، برای POST /api/public/consultation — مرجع API، باید تمایز روشنی بین ساختار مستند شده، تست خودکار و رفتار زنده قابل مشاهده وجود داشته باشد.

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"درخواست","consentGiven":true}

{"ok":true,"message":"درخواست مشاوره شما ارسال شد. به زودی با شما تماس خواهیم گرفت."}