Thông tin chung

Rate Limiting

API được áp dụng rate limiting để bảo vệ hệ thống.

Configuration

Parameter	Value	Description
Limit	300 requests	Số request tối đa trong window
Window	60 seconds	Cửa sổ thời gian
Tracking	Per API Key	Theo API Key từ header
Fallback	IP Address	Nếu không có API Key

Response Headers

Header	Type	Description	Example
X-RateLimit-Limit	number	Số request tối đa	300
X-RateLimit-Remaining	number	Số request còn lại	295
X-RateLimit-Reset	string	Thời điểm reset (ISO 8601)	2026-01-31T10:05:00Z

---

Error Responses

Not Found - 404

Trường hợp endpoint không tồn tại:

{
  "statusCode": 404,
  "timestamp": "2026-01-31T10:06:19.777Z",
  "path": "/api/v1/thong-tin-du-thi",
  "errorMessage": "HTTP Exception: 404 - Cannot GET /api/v1/thong-tin-du-thi"
}

Unauthorized - 401

Trường hợp API Key không hợp lệ hoặc thiếu:

{
  "statusCode": 401,
  "message": "Invalid API Key",
  "error": "Unauthorized"
}

Bad Request - 400

Trường hợp validation lỗi hoặc rate limit:

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": [
    "nam_hoc không được để trống",
    "hoc_ky không được để trống"
  ]
}

Rate Limit Exceeded - 429

Trường hợp vượt quá giới hạn request:

{
  "statusCode": 429,
  "message": "Too Many Requests",
  "error": "Rate limit exceeded. Please try again later."
}

---

Lưu ý chung

Lưu ý quan trọng khi tích hợp

• Lấy API Key: Liên hệ Trung tâm QLCNTT HUTECH (Email: tt.qlcntt@hutech.edu.vn, Zalo: 0976535298)
• Format Authorization: Authorization: ApiKey <API_KEY>
• Cache dữ liệu: Nên cache dữ liệu phía client để giảm số lượng request
• Pagination: Kiểm tra hasMore để biết còn dữ liệu hay không