Gói dịch vụ & thanh toán
Thông báo đang hiệu lực
Lấy các thông báo / banner của Hubport đang hiệu lực dành cho cửa hàng
Chỉ có trên Hubport SaaS
Trên bản cài đặt riêng (máy chủ riêng), endpoint trả HTTP 404 error_saas_mode_inactive.
Endpoint
GET /v1/platformannouncements/active
Yêu cầu đăng nhập. Trả các thông báo Hubport gửi tới cửa hàng (bảo trì, tính năng mới, nhắc thanh toán...) đang trong thời gian hiệu lực và khớp với đối tượng nhận (trạng thái cửa hàng, gói hiện tại hoặc chỉ định riêng cửa hàng). Tối đa 100 thông báo, mới nhất trước.
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
items | array | Danh sách thông báo |
items[].id | int | ID thông báo |
items[].title | string | Tiêu đề (văn bản thuần, không HTML) |
items[].content | string | Nội dung (văn bản thuần, không HTML, tối đa 5000 ký tự) |
items[].type | string | Loại: info, warning, maintenance, feature |
items[].placement | string | Vị trí hiển thị gợi ý: banner, popup, dashboard |
items[].link_url | string | Liên kết xem thêm (rỗng nếu không có) |
items[].dismissible | int | 1 nếu người dùng được phép tắt thông báo |
items[].starts_at | int | Thời điểm bắt đầu hiệu lực (Unix timestamp) |
items[].ends_at | int | Thời điểm hết hiệu lực (Unix timestamp, 0 = không thời hạn) |
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 403 | error_company_required | Phiên đăng nhập không gắn với công ty nào |
| 404 | error_saas_mode_inactive | Không phải Hubport SaaS |
Ví dụ
curl -X GET "https://api.hubport.vn/v1/platformannouncements/active" \
-H "Authorization: <JWT>"{
"items": [
{
"id": 7,
"title": "Bảo trì hệ thống",
"content": "Hubport bảo trì từ 23:00 đến 23:30 ngày 20/10. Một số chức năng có thể gián đoạn.",
"type": "maintenance",
"placement": "banner",
"link_url": "",
"dismissible": 1,
"starts_at": 1760317200,
"ends_at": 1760979600
}
]
}