POST/api/public/access-request

ส่งคำขอเข้าถึงสำหรับแพ็กเกจ (Starter, แบบกำหนดเอง หรือ Demo 14 วัน) เงื่อนไขก่อนคือต้องมีอีเมลที่ยืนยันไว้ก่อนแล้ว

ก่อนอื่นให้ยืนยันอีเมลผ่าน `POST /api/public/access-request/email/start-verification` และ `POST /api/public/access-request/email/verify` จากนั้นส่ง `name`, `email` เดียวกัน, แพ็กเกจ `package` (`starter`, `individual` หรือ `demo_access`), และ `verification_token` ที่ได้รับ สามารถส่ง `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` หรือ `stripe_sepa`), `wish` (`trial`, `subscription` หรือ `offer`; สำหรับการเข้าถึงแบบเดโมจะเป็น `trial` เสมอ), และ `message` เพิ่มเติมได้แบบไม่บังคับ หากไม่มีการยืนยันที่ถูกต้อง เซิร์ฟเวอร์จะตอบกลับด้วย 400 `EMAIL_NOT_VERIFIED` ช่องที่จำเป็นหายไป หรือค่าของแพ็กเกจ วิธีการชำระเงิน หรือความต้องการไม่ถูกต้อง จะทำให้เกิด 400 `VALIDATION_ERROR` คำขอที่สำเร็จทุกครั้งจะถูกสร้างใหม่และดำเนินการโดย Zentor ดังนั้นไม่ควรเรียกซ้ำโดยอัตโนมัติ สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP นอกจากนี้ยังมีกฎการเข้าถึงของ Zentor (กฎ IP ประเทศ และโดเมนอีเมล) บังคับใช้ด้วย การเรียกที่ถูกปฏิเสธจะได้รับ 403

ภาพรวม

การเรียกใช้: POST /api/public/access-request เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: name (body), email (body), package (body) พารามิเตอร์ที่ไม่บังคับ: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON

การยืนยันตัวตนและความปลอดภัย

ไม่ต้องยืนยันตัวตน

Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่

พารามิเตอร์

name(body, string, จำเป็น)— ชื่อ 2–120 ตัวอักษร
email(body, string, จำเป็น)— อีเมลที่ยืนยันไว้ก่อนแล้วผ่าน `/email/verify`
package(body, string, จำเป็น)— แพ็กเกจ: `starter`, `individual` หรือ `demo_access`
company(body, string)— บริษัท สูงสุด 160 ตัวอักษร (ไม่บังคับ)
phone(body, string)— หมายเลขโทรศัพท์ สูงสุด 40 ตัวอักษร (ไม่บังคับ)
companyWebsite(body, string)— เว็บไซต์บริษัท สูงสุด 200 ตัวอักษร (ไม่บังคับ)
paymentMethod(body, string)— วิธีการชำระเงิน: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` หรือ `stripe_sepa` (ไม่บังคับ)
wish(body, string)— ความต้องการ: `trial`, `subscription` หรือ `offer`; สำหรับ `demo_access` จะเป็น `trial` เสมอ (ไม่บังคับ)
message(body, string)— ข้อความ สูงสุด 3000 ตัวอักษร (ไม่บังคับ)

ตัวอย่างคำขอ

{"name":"สมชาย ใจดี","email":"max@example.com","package":"demo_access"}

ตัวอย่างการตอบกลับ

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"โปรดยืนยันที่อยู่อีเมลของคุณก่อน"}

รหัสข้อผิดพลาด

400 VALIDATION_ERROR — ช่องที่จำเป็นหายไป หรือแพ็กเกจ วิธีการชำระเงิน หรือความต้องการไม่ถูกต้อง
400 EMAIL_NOT_VERIFIED — อีเมลไม่ได้รับการยืนยันไว้ก่อนผ่าน `/email/start-verification` และ `/email/verify` หรือ `verification_token` หายไปหรือไม่ถูกต้อง

พฤติกรรมที่ตรวจสอบแล้ว

เนื้อหาคำขอที่ว่างเปล่าจะได้รับ 400 `VALIDATION_ERROR` ข้อมูลที่ถูกต้องแต่ไม่มีอีเมลที่ยืนยันแล้วจะได้รับ 400 `EMAIL_NOT_VERIFIED` กรณีสำเร็จเป็นไปตามขั้นตอนที่มีการบันทึกไว้หลังการยืนยันอีเมล

ฟอร์มสาธารณะ

POST /api/public/contactรับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม ZentorPOST /api/public/consultationรับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor AppPOST /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เปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ

บทความที่เกี่ยวข้อง

สร้างแบบฟอร์มในแชทบอทใช้ตัวสร้างแบบฟอร์มที่เมนูแชทบอท → แบบฟอร์ม เพื่อสร้างแบบฟอร์มของคุณเองที่กำหนดค่าได้อย่างอิสระ ซึ่งแชทบอทจะสอบถามอัตโนมัติระหว่างการสนทนาทำความเข้าใจการเข้าสู่ระบบและวิธีการเชื่อมต่อวิธีเข้าสู่ระบบอย่างปลอดภัย – และสามวิธีในการเชื่อมต่อ Zentor App กับระบบของคุณ
← ฟอร์มสาธารณะ