Chiến dịch

Nhóm API cho phép tra cứu chiến dịch và thống kê phản hồi khảo sát của cửa hàng Mini Gift.

Xác thực

Tất cả endpoint bên dưới đều yêu cầu header x-api-key. Xem chi tiết tại trang Giới thiệu Open API.

---

1. Lấy danh sách chiến dịch

Endpoint

🔗Endpoint Production

GET https://api.minigift.vn/api/v1/open/campaigns

Tham số truy vấn (Query Parameters)

Tham số	Kiểu	Bắt buộc	Mô tả
page	number	Không	Trang hiện tại (mặc định 1)
limit	number	Không	Số bản ghi mỗi trang (mặc định 10, tối đa 1000)
search	string	Không	Tìm kiếm theo tên chiến dịch
type	string	Không	Lọc theo loại chiến dịch

Ví dụ request

cURL

curl -X GET "https://api.minigift.vn/api/v1/open/campaigns?page=1&limit=10" \
  -H "x-api-key: sk_your_api_key_here"

Các trường trả về chính

Trường	Kiểu	Mô tả
id	string	ID của chiến dịch
name	string	Tên chiến dịch
type	string	Loại chiến dịch (minigame, receipt...)
status	string	Trạng thái chiến dịch
startDate	string (ISO 8601)	Thời điểm bắt đầu
endDate	string (ISO 8601)	Thời điểm kết thúc
createdAt	string (ISO 8601)	Thời điểm tạo
updatedAt	string (ISO 8601)	Thời điểm cập nhật gần nhất

Phản hồi (Response)

{
  "data": [
    {
      "id": "6651aa11b2c3d4e5f6a7b8c9",
      "name": "Vòng quay may mắn tháng 7",
      "type": "minigame",
      "status": "active",
      "startDate": "2026-07-01T00:00:00.000Z",
      "endDate": "2026-07-31T23:59:59.000Z",
      "createdAt": "2026-06-28T04:00:00.000Z",
      "updatedAt": "2026-06-30T09:20:00.000Z"
    }
  ],
  "meta": { "total": 1, "page": 1, "limit": 10 },
  "success": true
}

---

2. Thống kê phản hồi khảo sát

Trả về danh sách câu trả lời khảo sát của một chiến dịch (dùng để phân tích, xuất báo cáo).

Endpoint

🔗Endpoint Production

GET https://api.minigift.vn/api/v1/open/campaigns/{id}/feedback-statistics

Tham số đường dẫn (Path Parameters)

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	Có	ID của chiến dịch

Tham số truy vấn (Query Parameters)

Tham số	Kiểu	Bắt buộc	Mô tả
page	number	Không	Trang hiện tại (mặc định 1)
limit	number	Không	Số bản ghi mỗi trang

Ví dụ request

cURL

curl -X GET "https://api.minigift.vn/api/v1/open/campaigns/6651aa11b2c3d4e5f6a7b8c9/feedback-statistics?page=1&limit=20" \
  -H "x-api-key: sk_your_api_key_here"

Cấu trúc câu trả lời

Trường	Kiểu	Mô tả
surveyId	string	ID khảo sát
userId	string	ID người trả lời
answers[].questionId	string	ID câu hỏi
answers[].questionType	string	Loại câu hỏi (ví dụ single-select, multi-select)
answers[].questionText	string	Nội dung câu hỏi
answers[].answer	string[]	Đáp án người dùng chọn

Phản hồi (Response)

200 OK

{
  "data": [
    {
      "surveyId": "6651bb22c3d4e5f6a7b8c9d0",
      "userId": "6651cc33d4e5f6a7b8c9d0e1",
      "answers": [
        {
          "questionId": "6651dd44e5f6a7b8c9d0e1f2",
          "questionType": "single-select",
          "questionText": "Bạn đánh giá dịch vụ như thế nào?",
          "answer": ["Tốt"]
        }
      ],
      "createdAt": "2026-07-01T10:00:00.000Z"
    }
  ],
  "meta": { "total": 1, "page": 1, "limit": 20 },
  "success": true
}

404 Not Found

{
  "statusCode": 404,
  "message": "Không tìm thấy chiến dịch",
  "error": "Not Found"
}