Push NotificationsNotification Endpoint
Danh sách Endpoint của tôi
Lấy danh sách endpoint nhận thông báo của khách hàng đang đăng nhập.
Endpoint
GET /site/notificationendpoints/my
Headers
| Key | Value | Bắt buộc | Mô tả |
|---|---|---|---|
SiteTenantId | {tenant_id} | Có | ID của công ty/tenant. |
SiteAuthorization | {jwt_token} | Có | Token định danh khách hàng sau khi đăng nhập. |
Workflow & Logic
API này dùng để lấy danh sách tất cả endpoint nhận thông báo đang hoạt động (ACTIVE) của khách hàng đang đăng nhập.
Quy trình xử lý
-
Xác thực Session: Kiểm tra JWT token và xác định
company_id+customer_idtừ tokenSiteAuthorization. -
Tự động gán bộ lọc:
company_id→ lấy từ session.owner_type→ luôn là3(CUSTOMER).owner_id→ lấy từcustomer_idtrong session.status→ luôn là1(ACTIVE) — chỉ trả về endpoint đang hoạt động.
-
Lọc tùy chọn: Hỗ trợ lọc thêm qua query parameters
channel_type,app_code. -
Truy vấn: Lấy tối đa 100 bản ghi, sắp xếp theo
id DESC(mới nhất trước). -
Trả kết quả: Trả về danh sách endpoint kèm tổng số lượng.
Query Parameters (tùy chọn)
| Tên | Kiểu | Mô tả |
|---|---|---|
channel_type | int | Lọc theo loại kênh (VD: 9 cho Push Notification). |
app_code | string | Lọc theo mã ứng dụng (VD: pos, web). |
Response Schema (200)
{
"total": 2,
"items": [
{
"company_id": 123,
"creator_id": 0,
"id": 456,
"owner_type": 3,
"owner_id": 789,
"channel_type": 9,
"provider": "fcm",
"endpoint_value": "fcm_token_string...",
"app_code": "pos",
"platform": "android",
"device_id": "device-uuid-1",
"status": 1,
"error_message": "",
"ip_address": "192.168.1.1",
"date_last_used": 1740350000,
"date_created": 1740300000,
"date_modified": 1740320000
}
]
}Mỗi item trong mảng items là một đối tượng Notification Endpoint Object.
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 401 | error_customer_login_required | Thiếu SiteAuthorization hoặc token không hợp lệ/hết hạn. |
| 401 | error_customer_company_mismatch | Token khách hàng không thuộc shop của SiteTenantId. |
| 404 | error_company_not_found_from_site_tenant_id | SiteTenantId không hợp lệ hoặc shop không còn hoạt động. |