Chuyển tới nội dung chính

API Nhật ký Hoạt động & Truyền thông

Tài liệu các endpoint dành riêng cho Quản lý (Partner) để theo dõi lịch sử hoạt động hệ thống và gửi thông báo hàng loạt (Broadcast) đến các nhân viên hoặc khách hàng.

1. Nhật ký Hoạt động​

Lấy danh sách lịch sử thao tác của các nhân viên hoặc sự kiện trên hệ thống.

  • Method: GET
  • Endpoint: /api/vi-vn/v1/partner/activity-logs
  • Auth: auth:partner_api

Request Query​

Tham sốKiểuMô tả
pageintTrang hiện tại
per_pageintSố lượng bản ghi mỗi trang

Response Thành công​

{
  "data": [
    {
      "id": "log-1234",
      "action": "checkin",
      "description": "Nhân viên Nguyễn Văn A đã check-in cho khách Hạng Vàng.",
      "created_at": "2026-06-15T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 500
  }
}

2. Thống kê Nhật ký Hoạt động​

Lấy dữ liệu tổng hợp về các loại hoạt động trong một khoảng thời gian.

  • Method: GET
  • Endpoint: /api/vi-vn/v1/partner/activity-logs/analytics
  • Auth: auth:partner_api

Response Thành công​

{
  "total_activities": 500,
  "by_type": {
    "checkin": 120,
    "voucher_redemption": 45,
    "booking_approval": 80
  }
}

3. Quản lý Thông báo Partner​

Lấy danh sách các thông báo dành riêng cho cấp Quản lý.

  • Method: GET
  • Endpoint: /api/vi-vn/v1/partner/notifications
  • Auth: auth:partner_api

Response Thành công​

{
  "data": [
    {
      "id": "notif-001",
      "title": "Báo cáo doanh thu cuối ngày",
      "body": "Doanh thu cơ sở Zodutcan Q1 đạt 15,000,000 VND.",
      "is_read": false,
      "created_at": "2026-06-15T23:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 20
  }
}

4. Gửi Thông báo Hàng loạt​

Gửi thông báo Push Notification đến nhân viên hoặc danh sách khách hàng.

  • Method: POST
  • Endpoint: /api/vi-vn/v1/partner/notification-broadcasts
  • Auth: auth:partner_api

Request Body​

{
  "title": "Họp toàn chi nhánh",
  "message": "Yêu cầu tất cả nhân viên có mặt lúc 8h sáng mai.",
  "target_audience": "staff",
  "club_id": "club-001"
}

Response Thành công​

{
  "success": true,
  "message": "Đã gửi thông báo thành công tới 15 người."
}