POST/api/public/consultation

Nhận yêu cầu tư vấn từ biểu mẫu trên website Zentor App.

Trường bắt buộc là `name` (2–120 ký tự), `email` (địa chỉ email hợp lệ) và `consentGiven`, phải được đặt thành `true`. Có thể gửi thêm `company`, `phone` và `message` (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; sau đó đội ngũ Zentor sẽ liên hệ. 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`. Mỗi lệnh gọi thành công sẽ tạo một yêu cầu mới, do đó lệnh gọi này không có tính idempotent. 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/consultation. 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), consentGiven (body). Tham số tùy chọn: company (body), message (body), phone (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ệ
company(body, string)— Công ty (không bắt buộc)
message(body, string)— Nội dung (không bắt buộc)
phone(body, string)— Số điện thoại (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","company":"Musterfirma","message":"Yêu cầu","consentGiven":true}

Response mẫu

{"ok":true,"message":"Yêu cầu tư vấn của bạn đã được gửi. Chúng tôi sẽ liên hệ với bạn trong thời gian sớm nhất."}

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

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

Thông tin đầy đủ trả về 200; thông tin bị thiếu hoặc không hợp lệ trả về 400 `VALIDATION_ERROR`.

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

Bài viết liên quan

← Biểu mẫu công khai