POST/api/public/access-request/email/verify
Kiể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.
Gửi `verification_id` (từ `start-verification`), cùng `email` và `code` sáu chữ số. Khi thành công, phản hồi chứa `verified: true` và một `verification_token` mà bạn gửi kèm khi gửi yêu cầu truy cập qua `POST /api/public/access-request`. Mã sai hoặc đã hết hạn, `verification_id` không khớp, hoặc địa chỉ email khác nhau sẽ dẫn đến 400 `VERIFY_FAILED`. Trong trường hợp đó, hãy yêu cầu mã mới. Token chỉ có hiệu lực cho địa chỉ email này và không được xuất hiện trong URL hoặc nhật ký. Tối đa 10 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP.
Tổng quan
Lệnh gọi: POST /api/public/access-request/email/verify. 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: verification_id (body), email (body), code (body). Các trường hợp lỗi được tài liệu hóa: 400 VERIFY_FAILED. 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ố
verification_id(body, string, bắt buộc)— `verification_id` từ `start-verification`email(body, string, bắt buộc)— Địa chỉ email đã dùng khi yêu cầu mãcode(body, string, bắt buộc)— Mã sáu chữ số từ emailRequest mẫu
{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}Response mẫu
{"ok":true,"verified":true,"verification_token":"<Token cho yêu cầu cấp quyền truy cập tiếp theo>"}Mã lỗi
400 VERIFY_FAILED — Mã, `verification_id` hoặc địa chỉ email không đúng, hoặc mã đã hết hạn.Hành vi đã được xác minh
Mã không đúng trả về 400 `VERIFY_FAILED`. Trường hợp thành công tương ứng với xác nhận email của danh mục sản phẩm.
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-requestGử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 đó.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.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.