Skip to content

[GET] 버킷 홈 화면 조회

Gyunny edited this page Jun 11, 2021 · 12 revisions
메소드 경로 설명
GET /api/v2/buckets 버킷 홈 화면 조회

스크린샷 2021-05-30 오후 10 04 56

Request Header

{
    "Content-Type": "application/json",
    "token": "access Token"
}

QueryString 설명

Parameter 설명
state 버킷리스트 1(전체), 2(예정), 3(진행 중), 4(완료), 5(실패)
catogory 1(전체), 2(여행), 3(취미), 4(소유), 5(재정), 6(건강) 7(목표), 8(조직), 9(봉사), 10(기타)
sort 1(작성 순), 2(가나다 순)
Default 요청 예시
http://{{base_url}}/api/v2/buckets?state=1&category=1&sort=1

Response

< Success >

{
    "status": 200,
    "message": "버킷 리스트 조회 성공입니다.",
    "data": {
        "buckets": [
            {
                "id": 79,
                "userId": null,
                "bucketName": "string",
                "content": null,
                "createdDate": "2021-06-05 16:09:58",
                "endDate": "2022-03-03 00:00:00",
                "bucketState": 3,
                "categoryId": 2,
                "userProfileUrl": null,
                "fin": true,
                "bookmark": false,
                "alarmCheck": false
            },
            {
                "id": 1,
                "userId": null,
                "bucketName": "규니",
                "content": null,
                "createdDate": "2021-06-02 04:35:42",
                "endDate": "2020-02-02 00:00:00",
                "bucketState": 2,
                "categoryId": 2,
                "userProfileUrl": null,
                "fin": false,
                "bookmark": true,
                "alarmCheck": true
            }
        ],
        "bucketCount": 3
    }
}
  • alarmCheck: true(최신 알림 로그 확인 함), false(최신 알림 로그 확인 안함)

< Fail >

  • 데이터 누락
{
    "message": " Invalid Type Value",
    "status": 400,
    "errors": [
        {
            "field": "sort",     
            "value": "",
            "reason": "typeMismatch"
        }
    ],
    "code": "C005"
}
  • 서버 에러
{
  "message": "Server Error",
  "status": 500,
  "errors": [],
  "code": "C004"
}