Lấy danh sách nhóm học phần cần tính tỷ lệ dự thi

Mô tả

• API để lấy thông tin danh sách nhóm HP cần tính tỷ lệ dự thi từ ERP
• Chỉ trả về dữ liệu các nhóm học phần cần tính tỷ lệ dự thi

Endpoint

GET https://ttdt.api.ttithutech.com/api/v1/thong-tin-du-thi

Thuộc tính	Giá trị
Method	GET
Authentication	API Key

Headers

Header	Value
Authorization	ApiKey <API_KEY>
Content-Type	application/json

Lấy API Key

Liên hệ Trung tâm QLCNTT HUTECH để được cấp API Key

---

Query Parameters

Parameter	Type	Required	Description
nam_hoc	number	✅	Năm học (VD: 2025)
hoc_ky	string	✅	Học kỳ (VD: 1, 2, 3)
phan_he	string	❌	Mã phân hệ (VD: DHCD, DHCQ)
lastId	number	❌	ID của record cuối cùng từ lần load trước (cho pagination)

---

Example Request

GET /api/v1/thong-tin-du-thi?nam_hoc=2025&hoc_ky=2&phan_he=DHCD
Authorization: ApiKey <API_KEY>
Content-Type: application/json

---

Response Structure

{
  "data": [
    {
      "nam_hoc_guid": "b311f19a-6529-4d84-b3ea-d80b2c08c955",
      "ma_phan_he_guid": "6678F0DA-0022-4BCB-A1D9-62BBC8F440A2",
      "ma_mon_hoc": "CMP371",
      "ten_lop": "22DTHD6",
      "nhom_hoc": "01",
      "nhom_thuc_hanh": "001",
      "to_hop": "",
      "loai_mon_hoc": "LT",
      "ma_giang_vien": "HDM0040890"
    }
  ],
  "lastId": 1,
  "hasMore": true
}

Root Response

Field	Type	Description
data	array	Danh sách các nhóm học phần
lastId	number | null	ID của record cuối cùng, dùng cho pagination
hasMore	boolean	Còn dữ liệu ở page tiếp theo hay không

Data Item Object

Field	Type	Description
nam_hoc_guid	string	GUID của năm học
ma_phan_he_guid	string	GUID của phân hệ đào tạo
ma_mon_hoc	string	Mã môn học
ten_lop	string	Tên lớp
nhom_hoc	string	Nhóm học
nhom_thuc_hanh	string	Nhóm thực hành
to_hop	string	Tổ hợp nhóm
loai_mon_hoc	string	Loại giảng dạy (LT/TH)
ma_giang_vien	string	Mã giảng viên

---

Pagination

API GET sử dụng cursor-based pagination với trường lastId.

Quy trình lấy dữ liệu

1. Gọi API lần đầu không có lastId
2. Kiểm tra hasMore trong response:
   • Nếu hasMore = true: Lấy lastId từ response và gọi lại API với lastId
   • Nếu hasMore = false: Đã lấy hết dữ liệu

info

Số lượng record mỗi page được cấu hình trên server (mặc định 50 records/page). Con số này có thể thay đổi tùy thuộc tình trạng dịch vụ.

Ví dụ flow pagination

Request 1: GET /api/v1/thong-tin-du-thi?nam_hoc=2025&hoc_ky=1
Response 1: { data: [...], lastId: 1000, hasMore: true }

Request 2: GET /api/v1/thong-tin-du-thi?nam_hoc=2025&hoc_ky=1&lastId=1000
Response 2: { data: [...], lastId: 2000, hasMore: false }