POST/api/public/consultation

טופס בקשה לייעוץ ציבורי באתר Zentor.

העמוד "POST /api/public/consultation — API-Reference" עוסק בתחום הפונקציונלי המצוין ב-URL. התוכן הקיים משולב בתיאור התהליך בפועל, בתנאים המקדימים ובמגבלות הידועות. ערכת בניית הטפסים תומכת בטפסים הניתנים לתצורה חופשית, הכוללים מילות מפתח של הטריגר, סוגי שדות וסימון שדות חובה. הפונקציונליות נבדקה באופן E2E (קצה-לקצה). יש לקרוא את התיעוד של `POST /api/public/consultation` כתיאור טכני של נקודת הקצה הספציפית הזו. המפתח הוא המתודה, הנתיב, האימות, השדות החובה, השגיאות האפשריות והשאלה האם קריאה חוזרת מפעילה את אותה השפעה. לכן, ה-URL הנוכחי https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation אינו אמור להכיל הצהרות שיווקיות כלליות, אלא רק צעדי אינטגרציה ניתנים לביצוע ודוגמאות לתגובות מבוססות. לקריאה של `/api/public/consultation`, הבקשה נבנית בהתאם לרישום (Registry). נתיבים ציבוריים אינם דורשים מפתח API כללי למפתחים, מכיוון ש-Zentor אינה מציעה מערכת מפתחות כזו. לעומת זאת, נתיבי וידג'ט מוגנים משתמשים ב-Embed Token המוצג פעם אחת ובבדיקת Origin. יש להעריך יחד את סטטוס ה-HTTP ואת תוכן ה-JSON; שדה `ok` לבדו אינו מחליף טיפול בשגיאות. בבדיקה של `POST /api/public/consultation` יש להשתמש בערכים מאנונימיים. נתוני לקוחות אמיתיים, UUIDs בסביבת ייצור, אסימוני סשן וחותמות זמן ספציפיות אינם שייכים לדוגמאות ציבוריות. הגבול הידוע ברמת הפלטפורמה הוא 2,000 בקשות בתוך 15 דקות; מגבלה יחידה שונה אינה מאומתת. קריאות POST שאינן אידימפוטנטיות לא צריכות לחזור על עצמן באופן עיוור לאחר קריעה רשתית לא ברורה. שגיאות אינטגרציה אופייניות לנתיב זה נובעות מאי-התאמה של פרמטרים חסרים, סוגי נתונים שגויים, קודים חד-פעמיים שפג תוקפם, Origins לא מורשים או רשומה שאינה קיימת מראש. היישום צריך לטפל במקרים אלו בנפרד ולתעד את הודעת השגיאה המוחזרת על ידי נקודת הקצה, מבלי לכתוב תוכן חסוי. בקשה מוצלחת מאשרת רק שלב עיבוד זה, ולא בהכרח הצלחה עתידית של אימייל, תשלום או SSO. דבר זה רלוונטי מידית ל-"POST /api/public/consultation". הבדיקה הטכנית של עמוד זה צריכה להסתמך באופן מחייב על ה-Registry ב-`app/frontend/src/content/api-reference/` ועל נתיבי ה-Backend הרלוונטיים. הערות בדיקה חיות יכולות לטעון רק מה שנבדק בפועל. בדיקה שלילית או אנלוגיה בקוד אינם הוראת הצלחה מלאה. לכן, עבור "POST /api/public/consultation — API-Reference", יש להבחין בבירור בין המבנה המתועד, הבדיקה האוטומטית וההתנהגות החיה שנצפתה באופן בטוח.

{"name":"מקס מוסטרמן","email":"max@example.com","company":"חברת מוסטר","message":"בקשה","consentGiven":true}

{"ok":true,"message":"בקשת הייעוץ שלך נשלחה. נחזור אליך בקרוב."}