POST/api/public/contact
טופס יצירת קשר ציבורי באתר Zentor. יוצר בקשה במערכת הלידים הפנימית.
`POST /api/public/contact` מעבד את טופס הקשר הציבורי של אתר Zentor ושומר את הבקשה במערכת ה-Leads הפנימית. נקודת הקצה אינה דורשת אימות דשבורד ואינה אימפוטנטית. כל הגשה מוצלחת עלולה ליצור Lead חדש. על כן, על הממשק הקדמי להשבית את כפתור השליחה לאחר הלחיצה הראשונה ולא להפעיל חזרות אוטומטיות. שדות החובה המאומתים כוללים את `name`, `email` ו-`message`. השם חייב להיות באורך של 2 עד 120 תווים, כתובת הדוא"ל חייבת להיות בפורמט תקין, וההודעה חייבת לעמוד בכללי האימות של השרת. מותר לשלוח שדות נוספים רק אם הם מוגדרים במערכת (Schema) בפועל. ערכים לא מוכרים לא צריכים לשמש לשליטה בתכונות פנימיות של ה-Lead. טופס תקין בודק את שדות החובה בדפדפן, אך אינו מסתמך על בדיקה זו בלבד. השרת נשאר הגורם המכריע. במקרה של שגיאת אימות, הממשק צריך לסמן את השדה הרלוונטי ולשמור על התוכן שהוזן. הודעת הצלחה כללית יכולה להופיע רק לאחר קבלת תגובה חיובית מהשרת. טופס הקשר אינו ערוץ מאובטח עבור סיסמאות, מפתחות API, טוקנים של וידג'טים, נתוני תשלום או רשומות לקוחות מלאות. על המשתמשים לציין את מקרה השימוש, את המוצר הרלוונטי וכתובת דוא"ל עסקית שניתן ליצור קשר אליה. במקרה של תקלה טכנית, שם ה-Tenant, הזמן, הפונקציה המושפעת ושלבים הניתנים לשחזור יסייעו, מבלי להעביר תוכן אישי מיותר. תרחיש ריאלי: המבקר ממלא את השם, הדוא"ל וההודעה, מאשר את הודעות הפרטיות של האתר (אם רלוונטי) ושולח את הטופס. השרת מאמת את הנתונים, יוצר את ה-Lead ומחזיר תגובת הצלחה. במקרה של כתובת דוא"ל לא חוקית או שם קצר מדי, לא ייווצר Lead מלא. נקודת הקצה אינה יוצרת 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)— חייב להיות true (הסכמה להגנת מידע)Beispiel-Request
{"name":"מקס מוסטרמן","email":"max@example.com","message":"ההודעה שלך (מינימום 10 תווים).","consentGiven":true}Beispiel-Response
{"ok":true,"message":"הבקשה שלך נשלחה בהצלחה."}Fehlercodes
400 VALIDATION_ERROR — שדה חובה חסר/לא תקין, או שאישור הגנת הפרטיות חסר (מערך פרטים עם הודעות שגיאה בודדות).Live-Test-Nachweis
הצלחה (200) ומקרה שלילי (400, שדות חסרים כולל הסכמה חסרה) אומתו בזמן אמת.