Skip to content

[GET] 칭찬 카드 조회 탭

Gyunny edited this page Aug 14, 2021 · 8 revisions
메소드 경로 설명
GET /praise/:year/:month 전체 카드 조회 + 연도, 월별 칭찬 카드 조회

전체를 조회할 땐 year는 해당 연도 ex)2021 month는 0으로 setting
경로에 한 자릿수 월을 입력할 때는 ex)2월이면 2가 아닌 02 이런 식으로 입력하기


칭찬 카드 조회

Request Header

{
    "Content-Type": "application/json",
    "token" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWR4IjozNywiaWF0IjoxNjEyMzY1MTIwLCJleHAiOjE2MTQ5NTcxMjAsImlzcyI6InByYWlzZSJ9.x8dQd__KtOnM5T_uGr1w5ayq8KVpchhTlFQE21WBISM"
}

Request Params

이름 타입 설명
year Integer 조회할 연도
month Integer 조회할 월

Response

< Success >

  • 전체 칭찬 조회할 때
{
    "status": 200,
    "message": "칭찬 컬렉션 전체 조회 성공입니다",
    "data": {
        "praiseCount": 32,
        "firstDate": {
            "created_at": "2021-02-06T07:12:03.000Z"
        },
        "collectionPraise": [
            {
                "praisedName": "규니1",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니2",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니3",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "규니",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "희빈",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "정은",
                "created_at": "2020-12-21T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "정은",
                "created_at": "2020-12-27T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "다인",
                "created_at": "2021-02-03T00:00:00.000Z",
                "today_praise": "엄마 아빠 사랑해요"
            },
            {
                "praisedName": "정은",
                "created_at": "2021-02-08T00:00:00.000Z",
                "today_praise": "엄마 아빠 사랑해요"
            },
            {
                "praisedName": "정은",
                "created_at": "2021-02-08T00:00:00.000Z",
                "today_praise": "엄마 아빠 사랑해요"
            },
            {
                "praisedName": "정은",
                "created_at": "2021-02-08T00:00:00.000Z",
                "today_praise": "넌 참 사랑스러워"
            },
            {
                "praisedName": "정은",
                "created_at": "2021-02-08T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-09T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "넌 참 사랑스러워"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "vv",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "vv",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "vv",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "bbb",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "너가 내 친구라서 참 좋아"
            },
            {
                "praisedName": "bbb",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "엄마 아빠 사랑해요"
            },
            {
                "praisedName": "bbb",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "bbb",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "aaaaa",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffff",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            },
            {
                "praisedName": "ffffasdssd",
                "created_at": "2021-02-10T00:00:00.000Z",
                "today_praise": "난 정말 소중한 존재야"
            }
        ]
    }
}
  • 연도와 월별로 조회할 때
{
    "status": 200,
    "message": "칭찬 컬렉션 년,월별 조회 성공입니다",
    "data": {
        "praiseCount": 2,
        "firstDate": {
            "created_at": "2021-02-06T07:12:03.000Z"
        },
        "collectionPraise": [
            {
                "praisedName": "정균",
                "created_at": "2021-04-06T07:18:16.000Z",
                "today_praise": "수고했어, 오늘도"
            },
            {
                "praisedName": "호준",
                "created_at": "2021-04-06T07:18:13.000Z",
                "today_praise": "수고했어, 오늘도"
            }
        ]
    }
}

< Fail >

  • 칭찬 날짜가 없을 때
{
    "status": 404,
    "message": "칭찬한 이력이 없습니다"
}
  • 유효하지 않은 토큰
{
    "status": 401,
    "message": "유효하지 않은 토큰값입니다"
}
  • 토큰이 없을 때
{
    "status": 400,
    "message": "토큰 값이 없습니다"
}
  • 토큰이 만료되었을 때
{
    "status": 400,
    "message": "토큰 값이 만료되었습니다"
}
  • 서버 에러
{
    "status": 500,
    "message": "서버 내부 에러입니다"
}