Gói dịch vụ & thanh toán
Trạng thái nền tảng
Endpoint công khai cho biết máy chủ có phải Hubport SaaS và cấu hình đăng ký công khai
Endpoint
GET /v1/platformstatus
Endpoint công khai, không cần đăng nhập (không gửi Authorization). Hoạt động trên cả Hubport SaaS và bản cài đặt riêng. Dùng để:
- Biết máy chủ đang chạy Hubport SaaS hay bản cài đặt riêng (để bật/tắt các chức năng gói dịch vụ, thanh toán).
- Trang đăng ký cửa hàng biết đăng ký có đang mở, dùng captcha nào và số ngày dùng thử.
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
mode | string | saas (Hubport SaaS) hoặc dedicated (bản cài đặt riêng) |
signup_enabled | bool | (Chỉ khi mode = saas) Đăng ký cửa hàng mới đang mở |
signup_captcha_provider | string | (Chỉ khi mode = saas) Captcha bắt buộc khi đăng ký: none (không yêu cầu), turnstile (Cloudflare Turnstile), recaptcha (Google reCAPTCHA v2) |
signup_captcha_site_key | string | (Chỉ khi mode = saas) Site key công khai dùng để hiển thị widget captcha theo signup_captcha_provider. Rỗng khi không bật captcha hoặc hệ thống chưa cấu hình xong (lúc này đăng ký sẽ bị từ chối với error_captcha_not_configured) |
trial_days | int | (Chỉ khi mode = saas) Số ngày dùng thử mặc định cho cửa hàng mới |
demo_enabled | bool | (Chỉ khi mode = saas) Bản demo công khai đang mở (hiện nút "Xem demo"), xem Xem demo |
shop_domain_suffix | string | (Chỉ khi mode = saas) Đuôi tên miền con của cửa hàng, bắt đầu bằng dấu chấm (vd .hubport.com.vn); địa chỉ cửa hàng là screenname + đuôi này. Rỗng khi hệ thống chưa cấu hình. Xem Tên miền website |
Lưu ý
Response còn có thể chứa trường nội bộ khác; tích hợp bên ngoài chỉ nên dựa vào các trường được mô tả ở trên.
Ví dụ
curl -X GET "https://api.hubport.vn/v1/platformstatus"{
"mode": "saas",
"signup_enabled": true,
"signup_captcha_provider": "turnstile",
"signup_captcha_site_key": "<TURNSTILE_SITE_KEY>",
"trial_days": 7,
"shop_domain_suffix": ".hubport.com.vn"
}Trên bản cài đặt riêng:
{
"mode": "dedicated"
}