POST/api/public/contact
แบบฟอร์มติดต่อสาธารณะของเว็บไซต์ Zentor สร้างคำขอในระบบลีดภายใน
`POST /api/public/contact` ประมวลผลแบบฟอร์มติดต่อสาธารณะของเว็บไซต์ Zentor และบันทึกคำขอในระบบลีดภายใน จุดปลายทางนี้ไม่ต้องยืนยันตัวตนผ่านแดชบอร์ด และไม่ใช่ idempotent การส่งที่สำเร็จแต่ละครั้งอาจสร้างลีดใหม่ ดังนั้นฟรอนต์เอนด์ควรปิดปุ่มส่งหลังคลิกครั้งแรก และไม่ควรเรียกให้ส่งซ้ำอัตโนมัติ ฟิลด์บังคับที่ยืนยันแล้ว ได้แก่ `name`, `email` และ `message` ชื่อต้องมีความยาวระหว่าง 2 ถึง 120 ตัวอักษร อีเมลต้องมีรูปแบบที่ถูกต้อง และข้อความต้องเป็นไปตามกฎการตรวจสอบของเซิร์ฟเวอร์ ฟิลด์อื่น ๆ ส่งได้เฉพาะเมื่อมีกำหนดไว้ในสคีมาจริงเท่านั้น ไม่ควรใช้ค่าที่ไม่รู้จักเพื่อควบคุมคุณสมบัติภายในของลีด แบบฟอร์มที่ถูกต้องตรวจสอบฟิลด์บังคับในเบราว์เซอร์อยู่แล้ว แต่ไม่ควรพึ่งพาการตรวจสอบนี้เพียงอย่างเดียว เซิร์ฟเวอร์เป็นตัวตัดสิน หากเกิดข้อผิดพลาดในการตรวจสอบ หน้าจอควรทำเครื่องหมายที่ฟิลด์ที่เกี่ยวข้องและเก็บเนื้อหาที่กรอกไว้ ข้อความแจ้งความสำเร็จทั่วไปควรปรากฏหลังจากได้รับคำตอบเชิงบวกจากเซิร์ฟเวอร์เท่านั้น แบบฟอร์มติดต่อไม่ใช่ช่องทางที่ปลอดภัยสำหรับรหัสผ่าน คีย์ API โทเค็นวิดเจ็ต ข้อมูลการชำระเงิน หรือชุดข้อมูลลูกค้าฉบับเต็ม ผู้ใช้ควรระบุกรณีการใช้งาน ผลิตภัณฑ์ที่เกี่ยวข้อง และที่อยู่อีเมลธุรกิจที่ติดต่อได้ หากมีปัญหาทางเทคนิค ชื่อผู้เช่า เวลาที่เกิดปัญหา ฟังก์ชันที่ได้รับผลกระทบ และขั้นตอนที่ทำซ้ำได้จะช่วยได้ โดยไม่ต้องส่งเนื้อหาส่วนบุคคลที่ไม่จำเป็น ลำดับการทำงานที่สมจริง: ผู้เยี่ยมชมกรอกชื่อ อีเมล และข้อความ ยืนยันประกาศความเป็นส่วนตัวของเว็บไซต์ตามความเหมาะสม แล้วส่งแบบฟอร์ม เซิร์ฟเวอร์ตรวจสอบข้อมูล สร้างลีด และส่งคำตอบที่สำเร็จกลับมา หากอีเมลไม่ถูกต้องหรือชื่อสั้นเกินไป จะไม่สร้างลีดที่สมบูรณ์ จุดปลายทางนี้ไม่สร้างผู้เช่า ไม่จองแพ็กเกจ และไม่ใช่สิ่งทดแทนการกำหนดค่าผลิตภัณฑ์แบบมีโครงสร้างหรือกระบวนการให้คำปรึกษา เพื่อป้องกันสแปมและคำขอต่อเนื่องอัตโนมัติ ไคลเอนต์ควรเคารพข้อผิดพลาดจากเซิร์ฟเวอร์และไม่เริ่มลูปไม่สิ้นสุดทันที เมื่อได้รับคำตอบที่สำเร็จ ควรล้างฟิลด์ที่กรอกก็ต่อเมื่อเซิร์ฟเวอร์ยืนยันการรับแล้ว หากไม่มีคำตอบ ผู้ใช้สามารถเก็บเนื้อหาไว้และส่งอีกครั้งภายหลังอย่างควบคุมได้ สำหรับการจัดสรรภายใน ข้อความควรระบุสาเหตุที่แท้จริง โดยไม่มีคำโฆษณาสวยหรูหรือไฟล์แนบที่เป็นความลับ หัวเรื่องที่ชัดเจนและคำอธิบายปัญหาที่แม่นยำจะลดการสอบถามกลับ อย่างไรก็ตาม API เองไม่กำหนดลำดับความสำคัญที่รับประกัน และไม่ยืนยันกำหนดเวลาดำเนินการที่แน่นอน
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
name(body, string, จำเป็น)— 2–120 ตัวอักษรemail(body, string, จำเป็น)— ที่อยู่อีเมลที่ถูกต้องmessage(body, string, จำเป็น)— 10–3000 ตัวอักษรcompany(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, จำเป็น)— ต้องเป็น true (การยินยอมคุ้มครองข้อมูลส่วนบุคคล)ตัวอย่างคำขอ
{"name":"Max Mustermann","email":"max@example.com","message":"ข้อความของคุณ (อย่างน้อย 10 ตัวอักษร)","consentGiven":true}ตัวอย่างการตอบกลับ
{"ok":true,"message":"คำขอของคุณได้รับการส่งเรียบร้อยแล้ว"}รหัสข้อผิดพลาด
400 VALIDATION_ERROR — ขาดช่องบังคับ/ข้อมูลไม่ถูกต้อง หรือขาดการยินยอมคุ้มครองข้อมูลส่วนบุคคล (อาร์เรย์รายละเอียดพร้อมข้อความแจ้งเตือนแต่ละรายการ)หลักฐานการทดสอบแบบสด
ตรวจสอบสดแล้ว: กรณีสำเร็จ (200) และกรณีล้มเหลว (400, ฟิลด์ที่ขาดหายรวมถึงการยินยอมที่ขาดหาย)