페이지네이션(Pagination)

모든 목록 엔드포인트는 통일된 페이지네이션 응답 형태를 반환합니다.

응답 형태

{
  "total": 100,
  "page": 1,
  "page_size": 20,
  "items": [...]
}

필드	타입	설명
total	integer	쿼리 조건에 일치하는 전체 레코드 수
page	integer	현재 페이지 번호 (1부터 시작)
page_size	integer	페이지당 항목 수
items	array	현재 페이지의 레코드

---

요청 파라미터

페이지네이션은 쿼리 파라미터를 통해 제어됩니다. 참고: 사이즈 파라미터 이름이 엔드포인트마다 일관되지 않습니다 — GET /api/brand/list는 page_size를 사용하고, 그 외 모든 목록 엔드포인트는 size를 사용합니다.

엔드포인트	페이지 파라미터	사이즈 파라미터
GET /api/brand/list	page	page_size
GET /api/player/list	page	size
GET /api/player/{id}/transactions	page	size
GET /api/bet/list	page	size
GET /api/sports-bet/list	page	size

기본값 및 제한

파라미터	기본값	최대값
page	1	—
size / page_size	20	100

두 파라미터 모두 양의 정수(>= 1)여야 합니다. 유효 범위를 벗어나는 값을 전달하면 422 유효성 검증 오류가 반환됩니다.

---

알려진 비일관성

GET /api/brand/list는 page_size를 사용하지만, 그 외 모든 목록 엔드포인트는 size를 사용합니다. 이 비일관성은 현재 API에 존재하며, 향후 릴리스에서 해결될 예정입니다.