POST/api/public/contact
Nhậ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.
Trường bắt buộc là `name` (2–120 ký tự), `email` (địa chỉ email hợp lệ), `message` (10–3000 ký tự) và `consentGiven`, phải được đặt thành `true`. Có thể gửi thêm `company`, `phone` và `topic` (không bắt buộc). Khi thành công, server trả lời bằng `{"ok":true}` và một thông báo xác nhận. Nếu trường bắt buộc bị thiếu hoặc không hợp lệ, hoặc thiếu sự đồng ý, endpoint trả lời bằng 400 `VALIDATION_ERROR`; trường `details` liệt kê các lỗi riêng lẻ để bạn có thể đánh dấu các trường nhập liên quan. Mỗi lần gửi thành công sẽ tạo một yêu cầu mới. Do đó, hãy tắt nút gửi cho đến khi phản hồi đến và không tự động thử lại lệnh gọi. 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/contact. 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), message (body), consentGiven (body). Tham số tùy chọn: company (body), phone (body), topic (body). Các trường hợp lỗi được tài liệu hóa: 400 VALIDATION_ERROR. 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 hợp lệmessage(body, string, bắt buộc)— Nội dung, 10–3000 ký tựcompany(body, string)— Công ty (không bắt buộc)phone(body, string)— Số điện thoại (không bắt buộc)topic(body, string)— Chủ đề yêu cầu (không bắt buộc)consentGiven(body, boolean, bắt buộc)— Sự đồng ý về bảo vệ dữ liệu, phải là `true`Request mẫu
{"name":"Max Mustermann","email":"max@example.com","message":"Tin nhắn của bạn (tối thiểu 10 ký tự).","consentGiven":true}Response mẫu
{"ok":true,"message":"Yêu cầu của bạn đã được gửi."}Mã lỗi
400 VALIDATION_ERROR — Trường bắt buộc bị thiếu hoặc không hợp lệ, hoặc thiếu sự đồng ý về bảo vệ dữ liệu. `details` chứa các thông báo lỗi riêng lẻ.Hành vi đã được xác minh
Thông tin đầy đủ trả về 200; thiếu trường bắt buộc hoặc thiếu sự đồng ý trả về 400 `VALIDATION_ERROR`.
Biểu mẫu công khai
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.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.