POST/api/public/access-request/email/start-verification

Gử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.

Gửi địa chỉ cần xác nhận trong trường `email`. Phản hồi chứa `verification_id`, `expires_in_minutes` (10) và `resend_cooldown_seconds` (60). Sử dụng `verification_id` cùng với địa chỉ email đó và mã đã nhận trong `POST /api/public/access-request/email/verify`. Chỉ có thể gửi lại mã sau khi thời gian chờ kết thúc; hãy hiển thị thời gian còn lại trong giao diện của bạn. Nếu vượt quá giới hạn, endpoint trả lời bằng 429 `RATE_LIMIT_EXCEEDED`. Nếu email không gửi được, trả lời bằng 502 `MAIL_NOT_SENT`; trong trường hợp đó, hãy kiểm tra địa chỉ và thử lại sau.

Tổng quan

Lệnh gọi: POST /api/public/access-request/email/start-verification. 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: email (body). Các trường hợp lỗi được tài liệu hóa: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. 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

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.

Giới hạn tần suất: 10 Anfragen pro 15 Minuten (IP-basiert)

Lũy đẳng (idempotent): Không

Tham số

email(body, string, bắt buộc)— Địa chỉ email cần xác nhận

Request mẫu

{"email":"max@example.com"}

Response mẫu

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Mã lỗi

429 RATE_LIMIT_EXCEEDED — Quá nhiều yêu cầu từ địa chỉ IP này. Vui lòng chờ trước khi yêu cầu mã mới.
502 MAIL_NOT_SENT — Không thể gửi mã xác nhận qua email.

Hành vi đã được xác minh

Lệnh gọi trả về 200 kèm `verification_id`, và mã được gửi qua email; các lệnh gọi lặp lại trả về 429 `RATE_LIMIT_EXCEEDED`.

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/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.

Bài viết liên quan

← Biểu mẫu công khai