POST/api/public/consultation
รับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor App
ช่องที่จำเป็นได้แก่ `name` (2–120 ตัวอักษร), `email` (อีเมลที่ถูกต้อง), และ `consentGiven` ที่ต้องตั้งเป็น `true` สามารถส่ง `company`, `phone`, และ `message` เพิ่มเติมได้แบบไม่บังคับ เมื่อสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วย `{"ok":true}` และข้อความยืนยัน หลังจากนั้นทีม Zentor จะติดต่อกลับ หากช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมหายไป เอนด์พอยต์จะตอบกลับด้วย 400 `VALIDATION_ERROR` การเรียกที่สำเร็จแต่ละครั้งจะสร้างคำขอใหม่ ดังนั้นการเรียกนี้จึงไม่ใช่ idempotent สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP นอกจากนี้ยังมีกฎการเข้าถึงของ Zentor (กฎ IP ประเทศ และโดเมนอีเมล) บังคับใช้ด้วย การเรียกที่ถูกปฏิเสธจะได้รับ 403
ภาพรวม
การเรียกใช้: POST /api/public/consultation เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: name (body), email (body), consentGiven (body) พารามิเตอร์ที่ไม่บังคับ: company (body), message (body), phone (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 VALIDATION_ERROR ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
name(body, string, จำเป็น)— ชื่อ 2–120 ตัวอักษรemail(body, string, จำเป็น)— อีเมลที่ถูกต้องcompany(body, string)— บริษัท (ไม่บังคับ)message(body, string)— ข้อความ (ไม่บังคับ)phone(body, string)— หมายเลขโทรศัพท์ (ไม่บังคับ)consentGiven(body, boolean, จำเป็น)— ความยินยอมด้านความเป็นส่วนตัว ต้องเป็น `true`ตัวอย่างคำขอ
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"เรื่องที่ต้องการติดต่อ","consentGiven":true}ตัวอย่างการตอบกลับ
{"ok":true,"message":"คำขอคำปรึกษาของคุณได้รับการส่งเรียบร้อยแล้ว เราจะติดต่อกลับในเร็วๆ นี้"}รหัสข้อผิดพลาด
400 VALIDATION_ERROR — ช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมหายไปพฤติกรรมที่ตรวจสอบแล้ว
ข้อมูลที่สมบูรณ์จะได้รับ 200 ข้อมูลที่หายไปหรือไม่ถูกต้องจะได้รับ 400 `VALIDATION_ERROR`
ฟอร์มสาธารณะ
POST /api/public/contactรับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม ZentorPOST /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เปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ