[어드민][티켓] 티켓 리스트 업

GET

admin/tickets

Header

Bearer <adminAccessToken>

Query Params

name	type	description	Required
page	Int	현재 페이지 번호	Required
searchType	String	검색할 타입 ( smallGroup , phoneNumber, accountName, "")	Required
searchString	String	검색어	NotRequired

searchString 은 searchType이 존재했을시에 필요합니다.

->searchType이 ""일때도 searchString을 ""로 입력해야합니다. (validation처리에 필요함)

특히, searchType이 smallGroup 일 경우엔 searchString 이 "신청" 또는 "미신청" 이어야합니다.

Response

data : [Ticket]

manager 에 수정을 마지막으로 한 어드민의 정보가 들어옵니다. (하단 성공시 확인) manager은 있을수도 있고 없을 수도 있습니다.(optional) 최초 티켓 발급시 유저가 발급한경우에는 관련 어드민 정보가 없고 어드민이 공짜티켓이나 티켓을 직접 발급하는 경우에는 관련 어드민 정보가있습니다. 또한 입금 확인등 로그인한 어드민이 티켓의 정보를 변경하는 경우에도 관련 어드민 정보가 들어가게됩니다.

성공시

{
    "status": 200,
    "success": true,
    "data": {
        "totalResultCount": 1,
        "ticketList": [
            {
                "_id": "62037a022736fe7ca0a99054",
                "status": "confirm-deposit",
                "phoneNumber": "01094768640",
                "ticketNumber": 1,
                "adminTicket": false,
                "accountName": "이찬진",
                "studentID": "C211299",
                "smallGroup": true,
                "createdAt": "2022-02-09T08:23:30.341Z",
                "updatedAt": "2022-02-09T08:31:21.813Z",
                "__v": 0,
                "manager": {
                    "_id": "62037bc22736fe7ca0a99074",
                    "name": "이찬진"
                }
            }
        ],
        "nextPageNum": null
    }
}

• 내림차순 정렬

{
    "status": 200,
    "success": true,
    "data": {
        "totalResultCount": 20,
        "ticketList": [
            {
                "_id": "6203ce016ef4a14e939f3761",
                "status": "confirm-deposit",
                "phoneNumber": "01032419492",
                "ticketNumber": 5,
                "adminTicket": false,
                "accountName": "김재섭",
                "studentID": "C211111",
                "smallGroup": true,
                "createdAt": "2022-02-09T14:21:53.342Z",
                "updatedAt": "2022-02-10T14:41:44.816Z",
                "__v": 0,
                "manager": {
                    "_id": "620385096ef4a14e939f35cd",
                    "name": "노재탁"
                }
            },
            {
                "_id": "6203a4546ef4a14e939f3722",
                "status": "non-deposit",
                "phoneNumber": "01026239201",
                "ticketNumber": 4,
                "adminTicket": false,
                "accountName": "김뭔진",
                "studentID": "C211040",
                "smallGroup": false,
                "createdAt": "2022-02-09T11:24:04.723Z",
                "updatedAt": "2022-02-10T14:29:11.186Z",
                "__v": 0,
                "manager": {
                    "_id": "620385096ef4a14e939f35cd",
                    "name": "노재탁"
                }
            },
            {
                "_id": "6203a26f6ef4a14e939f3700",
                "status": "confirm-deposit",
                "phoneNumber": "01054139492",
                "ticketNumber": 3,
                "adminTicket": false,
                "accountName": "김원진",
                "studentID": "C211040",
                "smallGroup": true,
                "createdAt": "2022-02-09T11:15:59.669Z",
                "updatedAt": "2022-02-11T05:32:03.354Z",
                "__v": 0,
                "manager": {
                    "_id": "62039b876ef4a14e939f366e",
                    "name": "한규진"
                }
            },
            {
                "_id": "62038a4d6ef4a14e939f360a",
                "status": "pending-deposit",
                "phoneNumber": "01055364937",
                "ticketNumber": 2,
                "adminTicket": false,
                "accountName": "한규진",
                "studentID": "C211298",
                "smallGroup": false,
                "createdAt": "2022-02-09T09:33:02.055Z",
                "updatedAt": "2022-02-11T04:38:48.485Z",
                "__v": 0,
                "manager": {
                    "_id": "62039b876ef4a14e939f366e",
                    "name": "한규진"
                }
            },
            {
                "_id": "62037a022736fe7ca0a99054",
                "status": "non-deposit",
                "phoneNumber": "01094768640",
                "ticketNumber": 1,
                "adminTicket": false,
                "accountName": "이찬진",
                "studentID": "C211299",
                "smallGroup": true,
                "createdAt": "2022-02-09T08:23:30.341Z",
                "updatedAt": "2022-02-11T04:04:17.502Z",
                "__v": 0,
                "manager": {
                    "_id": "620385096ef4a14e939f35cd",
                    "name": "노재탁"
                }
            }
        ],
        "nextPageNum": null
    }
}

실패시

쿼리문 오류

error발생 상황	에러메세지
page넘버를 입력하지 않은 경우	page 넘버를 입력해주세요
page넘버에 숫자를 입력하지 않은 경우	숫자만 입력해야 합니다
searchType을 입력하지 않은 경우	검색타입을 입력해주세요
searchType을 잘 못 입력한 경우	입력 가능 검색 타입은 ``, accountNum, phoneNumber입니다
searchType은 null 값인데 searchString 값을 입력한 경우	검색타입을 확인하세요

{
    "status": 400,
    "success": false,
    "message": "검증오류",
    "data": [
        {
            "value": "",
            "msg": "숫자만 입력해야 합니다.",
            "param": "page",
            "location": "query"
        }
    ]
}

페이지 넘버에 0이 입력된 경우

{
    "status": 400,
    "success": false,
    "message": "페이지 넘버는 0보다 커야 합니다."
}

페이지 넘버가 너무 커서 결괏값이 없는 경우

{
    "status": 400,
    "success": false,
    "message": "페이지 넘버가 너무 큽니다."
}