POST/api/public/contact
รับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม Zentor
ช่องที่จำเป็นได้แก่ `name` (2–120 ตัวอักษร), `email` (อีเมลที่ถูกต้อง), `message` (10–3000 ตัวอักษร), และ `consentGiven` ที่ต้องตั้งเป็น `true` สามารถส่ง `company`, `phone`, และ `topic` เพิ่มเติมได้แบบไม่บังคับ เมื่อสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วย `{"ok":true}` และข้อความยืนยัน หากช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมหายไป เอนด์พอยต์จะตอบกลับด้วย 400 `VALIDATION_ERROR` ช่อง `details` จะแสดงรายการข้อผิดพลาดแต่ละรายการ เพื่อให้คุณสามารถระบุช่องข้อมูลที่เกี่ยวข้องได้ การส่งที่สำเร็จแต่ละครั้งจะสร้างคำขอใหม่ ดังนั้นควรปิดใช้งานปุ่มส่งจนกว่าจะได้รับการตอบกลับ และไม่ควรเรียกซ้ำโดยอัตโนมัติ สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP นอกจากนี้ยังมีกฎการเข้าถึงของ Zentor (กฎ IP ประเทศ และโดเมนอีเมล) บังคับใช้ด้วย การเรียกที่ถูกปฏิเสธจะได้รับ 403
ภาพรวม
การเรียกใช้: POST /api/public/contact เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: name (body), email (body), message (body), consentGiven (body) พารามิเตอร์ที่ไม่บังคับ: company (body), phone (body), topic (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 VALIDATION_ERROR ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
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 — ช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมด้านความเป็นส่วนตัวหายไป `details` มีรายการข้อผิดพลาดแต่ละรายการพฤติกรรมที่ตรวจสอบแล้ว
ข้อมูลที่สมบูรณ์จะได้รับ 200 ช่องที่จำเป็นหรือการยินยอมที่หายไปจะได้รับ 400 `VALIDATION_ERROR`
ฟอร์มสาธารณะ
POST /api/public/consultationรับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor AppPOST /api/public/access-requestส่งคำขอเข้าถึงสำหรับแพ็กเกจ (Starter, แบบกำหนดเอง หรือ Demo 14 วัน) เงื่อนไขก่อนคือต้องมีอีเมลที่ยืนยันไว้ก่อนแล้วPOST /api/public/access-request/email/start-verificationส่งโค้ดยืนยัน 6 หลักที่มีอายุ 10 นาทีไปยังอีเมลที่ระบุ – ขั้นตอนแรกของคำขอเข้าถึงPOST /api/public/access-request/email/verifyตรวจสอบโค้ดที่ส่งผ่านอีเมล และออกโทเค็นยืนยันสำหรับคำขอเข้าถึงที่จะดำเนินการต่อไปGET /api/public/access-request/payment-statusระบุว่าวิธีการชำระเงินใด (PayPal, Stripe) พร้อมใช้งานในขณะนี้สำหรับคำขอเข้าถึงGET /api/public/access-request/paypal/configส่งคืนการตั้งค่า PayPal สาธารณะ (เปิดใช้งาน โหมด สกุลเงิน) สำหรับขั้นตอนการชำระเงินPOST /api/public/access-request/paypal/create-orderสร้างคำสั่งซื้อ PayPal สำหรับแพ็กเกจที่เลือกPOST /api/public/access-request/paypal/capture-orderดำเนินการให้เสร็จสิ้น (capture) คำสั่งซื้อที่สร้างไว้ก่อนหน้าและได้รับการอนุมัติจากผู้ซื้อในหน้าชำระเงินของ PayPal จำนวนเงินกำหนดโดยเซิร์ฟเวอร์เท่านั้นPOST /api/public/access-request/stripe/create-checkoutสร้างเซสชันการชำระเงิน Stripe สำหรับแพ็กเกจที่เลือกPOST /api/public/activate-accountเปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ