[모아보기] 조건에 맞는 보드게임 조회하기

메소드	경로	뷰	요청 사항
POST	/game/filter/:pageIdx	모아보기	보드게임 필터로 검색 시

:pageIdx : 같은 필터로 몇 번째 서버 리퀘스트인지. Default = 0
필터 수정 사항이 있을 시 :pageIdx 는 0으로 초기화 해서 보내주세요.

↗️ Request Header

{
    "Content-Type":"application/json",
    "jwt":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWR4Ijo2LCJpYXQiOjE2MTAxNjM5NjIsImV4cCI6MTYxMDc2ODc2MiwiaXNzIjoiYXBvcGhpcyJ9.gM5avYDIhGybMsXqlvaWwqJCsTfkAjo1lYD2tvxZAdw",
}

↗️ Request Body

조건이 없을 시 디폴트 값은 다음과 같이 넘겨주세요!

{
    "playerNum": 0,
    "level": "",
    "tag": [],
    "duration": ""
}

↗️ Request Body

모든 파라미터로 검색하는 경우

{
    "playerNum": 2,
    "level": "하",
    "tag": ["간단한", "클래식"],
    "duration": "20분"
}

---

↘️ Response

🔵 success

필터 검색 결과가 20개 이상이면 20개씩 내려줍니다.
보드게임 총 개수를 확인하고 검색 결과가 20개 이상일 시 :pageIdx를 +1 해서 같은 필터 조건으로 다시 요청합니다.

{
    "status": 200,
    "success": true,
    "message": "보드게임 조건 검색 성공",
    "data": {
        "totalNum": 61,
        "searchedGame": [
            {
                "GameIdx": 1,
                "name": "사목게임",
                "intro": "가로, 세로 대각선 연속으로 4개를 한줄로 만들면 승리!",
                "imageUrl": "",
                "tag": [
                    "유명한",
                    "간단한",
                    "클래식"
                ],
                "saved": 1,
                "saveCount": 1,
                "star": 0
            },
            {
                "GameIdx": 2,
                "name": "다이아몬드 게임",
                "intro": "내 말을 움직여 반대편의 우리집으로 먼저 옮기자!",
                "imageUrl": "https://www.koreaboardgames.com/upload/uploaded/prd/639261505700784.png",
                "tag": [
                    "유명한",
                    "간단한",
                    "클래식"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 3,
                "name": "게스 후",
                "intro": "상대방이 고른 사람을 맞춰라!",
                "imageUrl": "",
                "tag": [
                    "유명한",
                    "간단한",
                    "클래식",
                    "스무고개"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 4,
                "name": "블링크",
                "intro": "필요한건 오직 스피드! 모양! 숫자! 색깔!",
                "imageUrl": "",
                "tag": [
                    "간단한",
                    "스피드",
                    "클래식"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 5,
                "name": "스트라테고 해적!",
                "intro": "사격을 통해 상대방의 깃발을 찾으면 승리! ",
                "imageUrl": "",
                "tag": [
                    "유명한",
                    "간단한",
                    "클래식",
                    "롤플레이"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 6,
                "name": "아발론",
                "intro": "내 구슬로 상대방의 구슬 6개를 먼저 떨어뜨려라!",
                "imageUrl": "https://www.koreaboardgames.com/upload/uploaded/prd/387981536797200.png",
                "tag": [
                    "머리쓰는",
                    "간단한"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 7,
                "name": "만칼라",
                "intro": "나의 만칼라에 구슬을 많이 모아보자!",
                "imageUrl": "",
                "tag": [
                    "머리쓰는",
                    "전략"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 8,
                "name": "듀크",
                "intro": "동양의 장기를 서양의 느낌으로!",
                "imageUrl": "",
                "tag": [
                    "머리쓰는",
                    "전략"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 9,
                "name": "쇼텐토텐",
                "intro": "포커 러버들을 위한 간단하지만 심오한 카드게임!",
                "imageUrl": "",
                "tag": [
                    "머리쓰는",
                    "카드"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            },
            {
                "GameIdx": 10,
                "name": "체스",
                "intro": "추상전략의 대명사는 역시 체스.",
                "imageUrl": "https://www.koreaboardgames.com/upload/uploaded/prd/865681519715298.png",
                "tag": [
                    "유명한",
                    "클래식",
                    "전략",
                    "머리쓰는"
                ],
                "saved": 0,
                "saveCount": 0,
                "star": 0
            }
        ]
    }
}

↗️ Request Body

보드게임 검색 결과가 없을 시

{
    "playerNum": 8,
    "level": "상",
    "tag": ["재밌는"],
    "duration": ""
}

---

↘️ Response

🔵 success

{
    "status": 200,
    "success": true,
    "message": "보드게임 조건 검색 성공",
    "data": {
        "totalNum": 0,
        "searchedGame": []
    }
}

❌ Fail

• 서버 에러

{
    "status": 500,
    "success": false,
    "message": "서버 내부 에러"
}