POST/api/public/access-request
Gửi yêu cầu truy cập cho một gói (Starter, Cá nhân hóa hoặc Demo 14 ngày). Điều kiện là địa chỉ email đã được xác nhận trước đó.
Đầu tiên xác nhận địa chỉ email qua `POST /api/public/access-request/email/start-verification` và `POST /api/public/access-request/email/verify`. Sau đó gửi `name`, cùng `email`, gói `package` (`starter`, `individual` hoặc `demo_access`) và `verification_token` đã nhận. Có thể gửi thêm `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` hoặc `stripe_sepa`), `wish` (`trial`, `subscription` hoặc `offer`; luôn là `trial` đối với truy cập demo) và `message` (không bắt buộc). Nếu không có xác nhận hợp lệ, server trả lời bằng 400 `EMAIL_NOT_VERIFIED`. Thiếu trường bắt buộc, hoặc giá trị gói, phương thức thanh toán hay mong muốn không hợp lệ, dẫn đến 400 `VALIDATION_ERROR`. Mỗi yêu cầu thành công được tạo mới và do Zentor xử lý, vì vậy không nên tự động thử lại lệnh gọi này. Tối đa 10 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP. Ngoài ra, các quy tắc truy cập của Zentor (quy tắc IP, quốc gia và miền email) cũng được áp dụng; các lệnh gọi bị từ chối sẽ nhận 403.
Tổng quan
Lệnh gọi: POST /api/public/access-request. Endpoint này thuộc nhóm “Biểu mẫu công khai” trong API của Zentor App. Endpoint này được truy cập công khai và không yêu cầu xác thực. Lệnh gọi không có tính idempotent: mỗi lệnh gọi thành công đều kích hoạt lại hành động. Tham số bắt buộc: name (body), email (body), package (body). Tham số tùy chọn: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Các trường hợp lỗi được tài liệu hóa: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Phản hồi mẫu bên dưới cho thấy cấu trúc của một phản hồi thành công ở định dạng JSON.
Xác thực & bảo mật
Không cần xác thực
Lũy đẳng (idempotent): Không
Tham số
name(body, string, bắt buộc)— Tên, 2–120 ký tựemail(body, string, bắt buộc)— Địa chỉ email đã được xác nhận trước đó qua `/email/verify`package(body, string, bắt buộc)— Gói: `starter`, `individual` hoặc `demo_access`company(body, string)— Công ty, tối đa 160 ký tự (không bắt buộc)phone(body, string)— Số điện thoại, tối đa 40 ký tự (không bắt buộc)companyWebsite(body, string)— Trang web công ty, tối đa 200 ký tự (không bắt buộc)paymentMethod(body, string)— Phương thức thanh toán: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` hoặc `stripe_sepa` (không bắt buộc)wish(body, string)— Mong muốn: `trial`, `subscription` hoặc `offer`; luôn là `trial` cho `demo_access` (không bắt buộc)message(body, string)— Nội dung, tối đa 3000 ký tự (không bắt buộc)Request mẫu
{"name":"Nguyễn Văn A","email":"max@example.com","package":"demo_access"}Response mẫu
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Vui lòng xác nhận địa chỉ email của bạn trước."}Mã lỗi
400 VALIDATION_ERROR — Trường bắt buộc bị thiếu, hoặc gói, phương thức thanh toán hoặc mong muốn không hợp lệ.400 EMAIL_NOT_VERIFIED — Địa chỉ email chưa được xác nhận trước qua `/email/start-verification` và `/email/verify`, hoặc `verification_token` bị thiếu hoặc không hợp lệ.Hành vi đã được xác minh
Body trống trả về 400 `VALIDATION_ERROR`; dữ liệu hợp lệ nhưng chưa có địa chỉ email được xác nhận trả về 400 `EMAIL_NOT_VERIFIED`. Trường hợp thành công theo quy trình đã ghi lại sau khi xác nhận email.
Biểu mẫu công khai
POST /api/public/contactNhận yêu cầu từ biểu mẫu liên hệ trên website Zentor App và chuyển tiếp cho đội ngũ Zentor.POST /api/public/consultationNhận yêu cầu tư vấn từ biểu mẫu trên website Zentor App.POST /api/public/access-request/email/start-verificationGửi mã xác nhận sáu chữ số có hiệu lực 10 phút đến địa chỉ email đã cho – bước đầu tiên của yêu cầu truy cập.POST /api/public/access-request/email/verifyKiểm tra mã được gửi qua email và cấp một token xác nhận cho yêu cầu truy cập tiếp theo.GET /api/public/access-request/payment-statusCho biết những phương thức thanh toán nào (PayPal, Stripe) hiện khả dụng cho yêu cầu truy cập.GET /api/public/access-request/paypal/configTrả về cấu hình PayPal công khai (kích hoạt, chế độ, loại tiền) cho bước thanh toán.POST /api/public/access-request/paypal/create-orderTạo một đơn hàng PayPal cho gói đã chọn.POST /api/public/access-request/paypal/capture-orderHoàn tất (capture) một đơn hàng đã được tạo trước đó và được người mua phê duyệt tại checkout PayPal. Số tiền chỉ do server xác định.POST /api/public/access-request/stripe/create-checkoutTạo một session checkout Stripe cho gói đã chọn.POST /api/public/activate-accountKích hoạt một tài khoản người dùng mới được tạo và đặt mật khẩu đầu tiên – được bắt đầu qua liên kết trong email mời.