Xem demo (vào shop mẫu)
Endpoint công khai cho nút "Xem demo": vào shop mẫu của Hubport không cần đăng ký, xem trạng thái demo
Hubport có hai shop mẫu để khách trải nghiệm không cần đăng ký: thời trang & mỹ phẩm (fashion) và spa & làm đẹp
(spa). Dữ liệu là mẫu, được làm mới định kỳ; một số tính năng gửi ra ngoài (email, SMS, kết nối sàn, cổng thanh toán...)
bị khoá trong bản demo.
Cách tích hợp đơn giản nhất là đặt link tới app, không cần gọi API:
| Nút | Link |
|---|---|
| Xem demo (chọn shop) | https://business.hubport.vn/demo |
| Xem demo thời trang | https://business.hubport.vn/demo?shop=fashion |
| Xem demo spa | https://business.hubport.vn/demo?shop=spa |
Trạng thái demo
GET /v1/platformdemo/info — công khai, không cần đăng nhập.
| Trường | Kiểu | Mô tả |
|---|---|---|
enabled | bool | Bản demo đang mở. false thì nên ẩn nút "Xem demo" |
session_ttl_minutes | int | Thời gian tối đa một phiên xem demo (phút) |
captcha_required | bool | Vào demo cần captcha (widget theo signup_captcha_provider / signup_captcha_site_key của Trạng thái nền tảng) |
shops[] | array | Shop mẫu: shop (fashion / spa), name, ready (đã sẵn sàng), storefront_url (website mẫu), last_reset_at (unix, lần làm mới gần nhất), reset_seq, resetting |
GET /v1/platformstatus cũng có demo_enabled (bool).
curl "https://api.hubport.vn/v1/platformdemo/info"{
"enabled": true,
"session_ttl_minutes": 240,
"captcha_required": true,
"shops": [
{"shop": "fashion", "name": "Mộc Miên Boutique", "ready": true, "storefront_url": "https://demo-thoitrang.hubport.com.vn", "last_reset_at": 1792112400, "reset_seq": 12, "resetting": false},
{"shop": "spa", "name": "Lá Spa & Beauty", "ready": true, "storefront_url": "https://demo-spa.hubport.com.vn", "last_reset_at": 1792112410, "reset_seq": 12, "resetting": false}
]
}Vào demo
POST /v1/platformdemo/enter — công khai. Trả phiên đăng nhập vào shop mẫu (như đăng nhập thường) kèm demo.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
shop | string | Có | fashion hoặc spa |
captcha_token | string | Khi captcha_required | Token captcha |
visitor | string | Không | Mã ngẫu nhiên của trình duyệt (đếm lượt khách) |
Phản hồi 200: giống đăng nhập (jwt, company, employee, role...) với refresh_token rỗng (phiên demo không gia hạn) và
demo: {shop, expires_at, entered_at, storefront_url}.
| Lỗi | Ý nghĩa |
|---|---|
404 error_demo_disabled | Bản demo đang tắt |
422 error_demo_shop_invalid | shop không hợp lệ |
422 error_captcha_required / error_captcha_invalid | Thiếu / sai captcha |
429 error_too_many_requests | Vào demo quá nhiều lần từ một địa chỉ IP |
503 error_demo_not_ready | Shop mẫu đang được chuẩn bị / làm mới, thử lại sau |
Trong phiên demo, API của tính năng bị khoá trả 403 {"error": ["error_demo_blocked"], "detail": {"feature": "..."}}; thao tác
ghi quá nhiều trả 429 error_demo_rate_limit.