Hướng Dẫn Chung

Xác Thực

• Tất cả các endpoint (ngoại trừ /api/v1/setup/* và /api/v1/auth/login) yêu cầu xác thực JWT
• Đưa token vào header yêu cầu: Authorization: Bearer <token>
• Token hết hạn trong 7 ngày
• Phản hồi xác thực thành công bao gồm đối tượng token và user

Giới Hạn Tốc Độ

• Giới hạn toàn cục: 500 yêu cầu mỗi phút
• Theo IP: Áp dụng cho tất cả các route /api/*
• Header phản hồi: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Phản Hồi Lỗi

{
  "error": "Thông báo lỗi",
  "statusCode": 400
}

Phân Trang

• Giới hạn mặc định: 50 mục
• Giới hạn tối đa: 100 mục
• Tham số: page, limit, offset
• Phản hồi bao gồm: data, total, page, limit

---