POST/api/public/consultation

แบบฟอร์มคำขอคำปรึกษาสาธารณะของเว็บไซต์ Zentor

หน้า "POST /api/public/consultation — API-Reference" ครอบคลุมพื้นที่การทำงานที่ระบุใน URL เนื้อหาที่มีอยู่ได้รับการเพิ่มเติมด้วยลำดับการทำงานจริง เงื่อนไขเบื้องต้น และข้อจำกัดที่ทราบ ระบบสร้างแบบฟอร์มรองรับการกำหนดค่าแบบอิสระสำหรับแบบฟอร์ม โดยใช้คำหลักสำหรับ Trigger ประเภทฟิลด์ และการระบุฟิลด์บังคับ ฟังก์ชันนี้ผ่านการทดสอบแบบ E2E เอกสารสำหรับ `POST /api/public/consultation` ต้องอ่านในฐานะคำอธิบายทางเทคนิคของ Endpoint เฉพาะนี้ สิ่งสำคัญคือ วิธีการ เส้นทาง การพิสูจน์ตัวตน ฟิลด์บังคับ ข้อผิดพลาดที่เป็นไปได้ และคำถามว่าการเรียกซ้ำจะก่อให้เกิดผลลัพธ์เดียวกันหรือไม่ ดังนั้น URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation ฉบับนี้จึงไม่ควรมีข้อความโฆษณาทั่วไป แต่ควรมีขั้นตอนการผสานรวมที่ดำเนินการได้ทันทีพร้อมตัวอย่างการตอบรับที่มีหลักฐาน สำหรับการเรียก `/api/public/consultation` จะสร้างคำขอตาม Registry เส้นทางสาธารณะไม่จำเป็นต้องใช้ API สำหรับนักพัฒนาทั่วไป เนื่องจาก Zentor ไม่เสนอระบบกุญแจดังกล่าว ในทางกลับกัน เส้นทาง Widget ที่ได้รับการป้องกันจะใช้ Embed-Token ที่แสดงเพียงครั้งเดียวและการตรวจสอบ Origin สถานะ HTTP และเนื้อหา JSON ต้องได้รับการประเมินร่วมกัน ฟิลด์ `ok` เพียงอย่างเดียวไม่สามารถแทนที่การจัดการข้อผิดพลาดได้ ในการทดสอบ `POST /api/public/consultation` ต้องใช้ค่าที่ผ่านการทำให้เป็นนิรนาม ข้อมูลลูกค้าจริง UUIDs ในสภาพแวดล้อมการผลิต โทเค็นเซสชัน และการประทับเวลาเฉพาะไม่ควรถูกใส่ในตัวอย่างสาธารณะ ค่าขีดจำกัดสูงสุดของแพลตฟอร์มที่ทราบคือ 2,000 คำขอภายใน 15 นาที ไม่มีขีดจำกัดรายบุคคลที่แตกต่างได้รับการยืนยัน การเรียก POST ที่ไม่ใช่ Idempotent ไม่ควรทำซ้ำโดยอัตโนมัติหลังจากการตัดขาดของเครือข่ายที่ไม่ชัดเจน ข้อผิดพลาดในการผสานรวมทั่วไปสำหรับเส้นทางนี้เกิดจากพารามิเตอร์บังคับที่ขาดหาย ประเภทข้อมูลที่ผิดพลาด รหัสใช้ครั้งเดียวที่หมดอายุ Origins ที่ไม่ได้รับอนุญาต หรือชุดข้อมูลที่ไม่ได้มีอยู่ล่วงหน้า การประยุกต์ใช้ควรจัดการกรณีเหล่านี้แยกกันและบันทึกข้อความข้อผิดพลาดที่ส่งกลับจาก Endpoint โดยไม่บันทึกเนื้อหาลับ การร้องขอที่สำเร็จยืนยันเฉพาะขั้นตอนการประมวลผลนี้เท่านั้น ไม่ได้อันตรธานความสำเร็จของอีเมล การชำระเงิน หรือ SSO ทันที สิ่งนี้มีความเกี่ยวข้องโดยตรงสำหรับ "POST /api/public/consultation" การตรวจสอบทางเทคนิคของหน้านี้ควรยึดตาม Registry ภายใต้ `app/frontend/src/content/api-reference/` และเส้นทาง Backend ที่เกี่ยวข้อง การบันทึกการทดสอบในสภาพจริงต้องระบุเฉพาะสิ่งที่ได้รับการตรวจสอบจริง การทดสอบเชิงลบหรือการเปรียบเทียบโค้ดไม่ใช่คำสั่งความสำเร็จที่สมบูรณ์ ดังนั้นสำหรับ POST /api/public/consultation — API-Reference จึงต้องแยกแยะอย่างชัดเจนระหว่างโครงสร้างที่บันทึกไว้ การทดสอบอัตโนมัติ และพฤติกรรมในสภาพจริงที่สังเกตได้อย่างปลอดภัย

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"เรื่องที่ต้องการติดต่อ","consentGiven":true}

{"ok":true,"message":"คำขอคำปรึกษาของคุณได้รับการส่งเรียบร้อยแล้ว เราจะติดต่อกลับในเร็วๆ นี้"}