윌스너 예약 요청 리스트 - Willson-2019/Willson-Server GitHub Wiki

URL

[POST] ~/api/v1/willsoner/list/realtime/matches

REQUEST	PARAMETER NAME	DESCRIPTION
header	x-token	엑세스 토큰 access token
header	Content-Type	application/json
body	date	캘린더 날짜 : Date ("YYYY-MM-DD")
body	category_idx	카테고리 인덱스 : Int

---

• 처음 선택되는 값은 예약 매칭 중 가장 빠른 날짜의 결과 => body에 date 보내지 않아도 됨
• body에 date를 넣어 보낼 경우 해당 날짜와 일치하는 예약 결과 출력
• category_idx가 0 or null(body.category_idx를 보내지 않을 경우)일 때는 전체 카테고리에 대한 검색 결과 출력
• matches의 status값 매칭 상태값
  • init : 타이머 표시
  • waiting : 질문자의 확정을 기다리는 중입니다 표시

---

요청예시

body

{
	"date": "2020-01-31",
        "category_idx" : 1
}

응답예시

성공

• body에 어떠한 값도 보내지 않는 경우

{
    "code": "success",
    "message": "success",
    "data": {
        "categories": [
            {
                "idx": 0,
                "name": "전체"
            },
            {
                "idx": 1,
                "name": "연애"
            },
            {
                "idx": 2,
                "name": "진로"
            },
            {
                "idx": 3,
                "name": "일상"
            },
            {
                "idx": 4,
                "name": "대인관계"
            },
            {
                "idx": 5,
                "name": "자존감"
            },
            {
                "idx": 6,
                "name": "기타"
            }
        ],
        "dates": [
            {
                "date": "2020-03-13"
            },
            {
                "date": "2020-03-14"
            },
            {
                "date": "2020-03-15"
            }
        ],
        "matches": {
            "count": 1,
            "rows": [
                {
                    "idx": 614,
                    "status": "waiting",
                    "concern": {
                        "content": "past reserve matchhhhhhhhhhh",
                        "time": "60",
                        "asker": {
                            "gender": "여",
                            "age": "40대 초중반",
                            "nickname": "하이하이"
                        },
                        "subcategory": {
                            "name": "짝사랑",
                            "category": {
                                "name": "연애"
                            }
                        },
                        "feelings": [
                            {
                                "name": "행복해요"
                            },
                            {
                                "name": "자랑스러워요"
                            }
                        ],
                        "dates": [
                            {
                                "from_time": "16:00",
                                "to_time": "21:30",
                                "date_format": "03월 13일"
                            },
                            {
                                "from_time": "12:30",
                                "to_time": "15:00",
                                "date_format": "03월 13일"
                            }
                        ]
                    }
                }
            ]
        }
    }
}

• date : "2020-03-15"에 대한 결과

{
    "code": "success",
    "message": "success",
    "data": {
        "categories": [
            {
                "idx": 0,
                "name": "전체"
            },
            {
                "idx": 1,
                "name": "연애"
            },
            {
                "idx": 2,
                "name": "진로"
            },
            {
                "idx": 3,
                "name": "일상"
            },
            {
                "idx": 4,
                "name": "대인관계"
            },
            {
                "idx": 5,
                "name": "자존감"
            },
            {
                "idx": 6,
                "name": "기타"
            }
        ],
        "dates": [
            {
                "date": "2020-03-13"
            },
            {
                "date": "2020-03-14"
            },
            {
                "date": "2020-03-15"
            }
        ],
        "matches": {
            "count": 1,
            "rows": [
                {
                    "idx": 606,
                    "status": "init",
                    "concern": {
                        "content": "reserve matchhhhhhhhhhh",
                        "time": "60",
                        "asker": {
                            "gender": "여",
                            "age": "40대 초중반",
                            "nickname": "하이하이"
                        },
                        "subcategory": {
                            "name": "짝사랑",
                            "category": {
                                "name": "연애"
                            }
                        },
                        "feelings": [
                            {
                                "name": "행복해요"
                            },
                            {
                                "name": "자랑스러워요"
                            }
                        ],
                        "dates": [
                            {
                                "from_time": "11:30",
                                "to_time": "15:00",
                                "date_format": "03월 15일"
                            }
                        ]
                    }
                }
            ]
        }
    }
}

결과가 없는 경우

{
    "code": "match_not_found",
    "message": "Match not found."
}

access token이 만료된 경우

{
    "code": "access_token_expired",
    "message": "Access token expired"
}

결과를 찾지 못한 경우

{
    "code": "not_found",
    "message": "Result not found"
}