POST/api/public/access-request/email/start-verification
ส่งโค้ดยืนยัน 6 หลักที่มีอายุ 10 นาทีไปยังอีเมลที่ระบุ – ขั้นตอนแรกของคำขอเข้าถึง
ส่งอีเมลที่ต้องการยืนยันในช่อง `email` การตอบกลับจะมี `verification_id`, `expires_in_minutes` (10), และ `resend_cooldown_seconds` (60) ใช้ `verification_id` ร่วมกับอีเมลเดียวกันและโค้ดที่ได้รับใน `POST /api/public/access-request/email/verify` การส่งใหม่จะทำได้ก็ต่อเมื่อเวลารอสิ้นสุดแล้ว ควรแสดงเวลาที่เหลือในอินเทอร์เฟซของคุณ หากเกินขีดจำกัด เอนด์พอยต์จะตอบกลับด้วย 429 `RATE_LIMIT_EXCEEDED` หากไม่สามารถส่งอีเมลได้ จะตอบกลับด้วย 502 `MAIL_NOT_SENT` ในกรณีนั้นให้ตรวจสอบที่อยู่และลองใหม่อีกครั้งในภายหลัง
ภาพรวม
การเรียกใช้: POST /api/public/access-request/email/start-verification เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: email (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP นอกจากนี้ยังมีกฎการเข้าถึงของ Zentor (กฎ IP ประเทศ และโดเมนอีเมล) บังคับใช้ด้วย การเรียกที่ถูกปฏิเสธจะได้รับ 403
ขีดจำกัดอัตรา (Rate-Limit): 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
email(body, string, จำเป็น)— อีเมลที่ต้องการยืนยันตัวอย่างคำขอ
{"email":"max@example.com"}ตัวอย่างการตอบกลับ
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}รหัสข้อผิดพลาด
429 RATE_LIMIT_EXCEEDED — มีคำขอมากเกินไปจากที่อยู่ IP นี้ กรุณารอก่อนขอโค้ดใหม่502 MAIL_NOT_SENT — ไม่สามารถส่งโค้ดยืนยันผ่านอีเมลได้พฤติกรรมที่ตรวจสอบแล้ว
การเรียกจะได้รับ 200 พร้อม `verification_id` และโค้ดจะถูกส่งผ่านอีเมล การเรียกซ้ำจะได้รับ 429 `RATE_LIMIT_EXCEEDED`
ฟอร์มสาธารณะ
POST /api/public/contactรับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม ZentorPOST /api/public/consultationรับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor AppPOST /api/public/access-requestส่งคำขอเข้าถึงสำหรับแพ็กเกจ (Starter, แบบกำหนดเอง หรือ Demo 14 วัน) เงื่อนไขก่อนคือต้องมีอีเมลที่ยืนยันไว้ก่อนแล้ว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เปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ