게임 목록 조회

게임 목록 조회

get

페이지네이션과 필터링을 지원하는 게임 목록을 조회합니다. 브랜드, 게임 타입, 검색어로 필터링할 수 있습니다.

쿼리 스트링을 통해 페이지네이션과 검색을 수행할 수 있습니다.

쿼리 스트링이 지정되지 않은 경우, 등록된 순서대로 조회됩니다.

---

주요 기능:

• 페이지네이션 지원 (기본 200개씩)

• 다중 필터링 옵션

• 정렬 기능 (ID 순)

• 총 게임 수 및 페이지 정보

필터링 옵션:

• 브랜드: 특정 게임 프로바이더로 제한

• 게임 타입: SLOT, LIVE_CASINO 등으로 분류

• 검색어: 게임 제목 기반 검색 (시작 문자 일치)

권한 및 제한:

• Agent별 허용된 프로바이더만 조회

• 프로젝트 설정에 따른 게임 목록 제한

• 비활성화된 게임 자동 제외

응답 정보:

• 게임 기본 정보 목록

• 페이지네이션 메타데이터

• 필터링 결과 통계

성능 최적화:

• 인덱스 기반 정렬

• 필요한 필드만 선택 조회

• 캐싱 적용 (해당하는 경우)

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Query parameters

brandstringOptional

브랜드명으로 필터링

Example: PG_SOFT

typestring · enumOptional

게임 타입으로 필터링

Possible values:

searchStringstringOptional

게임 제목 검색어 (시작 문자 일치)

Example: Fortune

sizenumberOptional

페이지 크기 (기본값: 200)

Example: 20

pagenumberOptional

페이지 번호 (1부터 시작)

Example: 1

Responses

200

게임 목록 조회 성공

application/json

400

잘못된 쿼리 파라미터

application/json

401

인증 실패

application/json

500

서버 내부 오류

application/json

get

/api/games

HTTPcURLJavaScriptPython

GET /api/games HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Accept: */*

{
  "games": [
    {
      "id": 123,
      "title": "Fortune Tiger",
      "brand": "PG_SOFT",
      "type": "SLOT",
      "imageUrl": "https://images.provider.com/fortune-tiger.jpg",
      "rtp": 96.81,
      "volatility": "HIGH",
      "createdAt": "2024-01-15T09:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 2580,
    "page": 1,
    "size": 20,
    "totalPages": 129,
    "hasNext": true,
    "hasPrev": false
  },
  "filters": {
    "brand": "PG_SOFT",
    "type": "SLOT",
    "searchString": "Fortune"
  }
}