SnapSpot API

참고: [React] Axios / 파일과 객체를 동시에 서버에 전송하기 / FormData

Auth

일반 회원가입

회원가입 유형을 선택하고 필요 정보를 입력한 뒤 일반 회원가입을 합니다.
Method: POST
URI: /auth/signup

Request Body

{
    "role" : "ROLE_MEMBER",
    "email" : "[email protected]",
    "nickname" : "traveler",
    "password" : "tourlover123" 
}

Success Response

HTTP Status Code: 201 Created

{
    "nickname" : "traveler",
    "email" : "[email protected]",
    "role" : "ROLE_MEMBER"
}

일반 로그인

아이디와 비밀번호를 입력하고 로그인합니다.
Method: POST
URI: /auth/signin

Request Body

{
    "email" : "[email protected]",
    "password" : "tourlover123"
}

Success Response

HTTP Status Code: 201 Created

{
    "email": "[email protected]",
    "token": {
        "accessToken": "Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b3VybG92ZXJAZ21haWwuY29tIiwicm9sZSI6IlJPTEVfTUVNQkVSIiwiZXhwIjoxNjk0NDQ1Mjk0fQ.pwTjZdx6KFGWiq5w0hm9hlUUgeiAUBmOx4lYbfCyggI",
        "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2OTQ3OTA4OTR9.zGIAE1sXwgMvT1C44S0c8INrXM_kkGOqF1uaMw7o_Vc"
    }
}

카카오 회원가입

회원가입 유형을 선택하고 카카오 계정으로 회원가입합니다.
Method: POST
URI: /auth/kakao/signup

Request Body

{
    "accessToken" : "Mg6j23h5mUCy0yZkzx9TVpu6kJXggo7tcsd070VmCiolTwAAAYpACPLH",
    "refreshToken" : "Mg6j23h5mUCy0yZkzx9TVpu6kJXggo7tcsd070VmCiolTwAAAYpACPLH",
    "role" : "ROLE_PHOTOGRAPHER"
}

Success Response

HTTP Status Code: 201 Created

{
    "nickname" : "happysnap",
    "email" : "[email protected]",
    "role" : "ROLE_PHOTOGRAPHER"
}

카카오 로그인

카카오 계정으로 로그인합니다.
Method: POST
URI: /auth/kakao/signin

Request Body

{
    "accessToken" : "Mg6j23h5mUCy0yZkzx9TVpu6kJXggo7tcsd070VmCiolTwAAAYpACPLH",
    "refreshToken" : "Mg6j23h5mUCy0yZkzx9TVpu6kJXggo7tcsd070VmCiolTwAAAYpACPLH"
}

Success Response

HTTP Status Code: 201 Created

{
    "email" : "[email protected]",
    "token": {
        "accessToken": "Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJwaG90b2xvdmVAZ21haWwuY29tIiwicm9sZSI6IlJPTEVfTUVNFSKLDJjkldjfkSALmcnkQxNzIxfQ.ZBobiIRrAyeTlRKRu0BCsfdjl_jkj24ljsodjf55LSQ",
        "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eysdfjlkEOXMXczMjF9.vVO8xEbzklkmnmzncbzCBNXMCiIgE1340tlW_5Q"
    }
}

Member

고객 계정 정보 조회

토큰으로 고객 계정 정보를 조회합니다.
Method: GET
URI: /members/me
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

{
    "email": "[email protected]",
    "nickname": "traveler",
    "profile" : null,
    "role": "ROLE_MEMBER"
}

고객 계정 정보 수정

고객 계정 정보(닉네임, 이메일, 프로필 사진)를 수정합니다.
Method: PUT
URI: /members/setting

Request Body
Headers: Authorization

{
    "nickname" : "예지",
    "profileImage" : "http://profile.com/profile123",
    "email" : "[email protected]",
    "password" : "yeji"
}

Success Response

HTTP Status Code: 200 OK

{
    "email": "[email protected]",
    "nickname": "예지",
    "profile" : "http://profile.com/profile123",
    "role": "ROLE_MEMBER"
}

Photographer

사진 작가 계정 정보 조회

토큰으로 사진 작가 계정 정보를 조회합니다.
Method: GET
URI: /photographers/me
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

{
    "member": {
        "email": "[email protected]",
        "nickname": "happysnap",
      "profile": null,
        "role": "ROLE_PHOTOGRAPHER"
    },
    "photographerId": 19,
    "lowestPay": null,
    "paymentImage": null,
    "bio": null,
    "images": {
        "image1": null,
        "image2": null,
        "image3": null,
        "image4": null,
        "image5": null,
        "image6": null,
        "image7": null,
        "image8": null,
        "image9": null,
        "image10": null
    },
    "areas": [],
    "unableSchedules": {
        "unableDates": []
    },
    "sns": {
        "homepage": null,
        "instagram": null,
        "kakaoChannel": null,
        "twitter": null,
        "naverBlog": null
    },
    "specialList": {
        "keywords": []
    },
    "tags": {
        "tag1": null,
        "tag2": null,
        "tag3": null
    }
}

사진 작가 계정 정보 수정

사진 작가 계정 정보(닉네임, 이메일, 프로필 사진)를 수정합니다.
Method: PUT
URI: /photographers/setting

Request Body
Headers: Authorization

{
    "nickname" : "사진작가예지",
    "profileImage" : "http://ewha.com/ewha",
    "email" : "[email protected]",
    "password" : "kimyeji"
}

Success Response

HTTP Status Code: 200 OK

{
    "email": "[email protected]",
    "nickname": "사진작가예지",
    "profile" : "http://ewha.com/ewha",
    "role": "ROLE_PHOTOGRAPHER"
}

사진 작가 프로필 수정 (작가 페이지 커스텀)

사진 작가 프로필 정보를 수정합니다.
Method: PUT
URI: /photographers/me

Request Body
Headers: Authorization

{
    "nickname" : "행복스냅",
    "profileImage" : "https://test.profile.com",
    "paymentImage" : "https://test.payment.com",
    "lowestPay" : 50000,
    "bio" : "자연스러운 모습을 담아드려요",
    "areaId" : [1, 2, 3],
    "sns" : {
        "instagram" : "happysnap_",
        "twitter" : "happysnap_",
        "kakaoChannel" : "https://pf.kakao.com/_happySNAP",
        "naverBlog" : "https://blog.naver.com",
        "homepage" : "https://happysnap.com"          
     },
    "specialList" : ["FRIEND"],
    "tag" : {
        "tag1" : "친구",
        "tag2" : "추억",
        "tag3" : "몽환적"
    },
    "unableDates" : ["2023-11-11T00:00:00"],
    "image" : {
        "image1" : "https://test.image1.com",
        "image2" : "https://test.image2.com",
        "image3" : "https://test.image3.com",
        "image4" : "https://test.image4.com",
        "image5" : "https://test.image5.com"
    }
}

Success Response

HTTP Status Code: 200 OK

{
    "member": {
        "email": "[email protected]",
        "nickname": "행복스냅",
        "profile": "https://test.profile.com",
        "role": "ROLE_PHOTOGRAPHER"
    },
    "photographerId": 19,
    "lowestPay": 50000,
    "paymentImage": "https://test.payment.com",
    "bio": "자연스러운 모습을 담아드려요",
    "images": {
        "image1": "https://test.image1.com",
        "image2": "https://test.image2.com",
        "image3": "https://test.image3.com",
        "image4": "https://test.image4.com",
        "image5": "https://test.image5.com",
        "image6": null,
        "image7": null,
        "image8": null,
        "image9": null,
        "image10": null
    },
    "areas": [],
    "unableSchedules": {
        "unableDates": [
            "2023-11-11T00:00:00"
        ]
    },
    "sns": {
        "homepage": "https://happysnap.com",
        "instagram": "happysnap_",
        "kakaoChannel": "https://pf.kakao.com/_happySNAP",
        "twitter": "happysnap_",
        "naverBlog": "https://blog.naver.com"
    },
    "specialList": {
        "keywords": [
            "FRIEND"
        ]
    },
    "tags": {
        "tag1": "친구",
        "tag2": "추억",
        "tag3": "몽환적"
    }
}

사진 작가 개별 조회

사진 작가 한 명을 조회합니다.
Method: GET
URI: /photographers/{photographerId}
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "member": {
        "email": "[email protected]",
        "nickname": "행복스냅",
        "profile": "https://test.profile.com",
        "role": "ROLE_PHOTOGRAPHER"
    },
    "photographerId": 19,
    "lowestPay": 50000,
    "paymentImage": "https://test.payment.com",
    "bio": "자연스러운 모습을 담아드려요",
    "images": {
        "image1": "https://test.image1.com",
        "image2": "https://test.image2.com",
        "image3": "https://test.image3.com",
        "image4": "https://test.image4.com",
        "image5": "https://test.image5.com",
        "image6": null,
        "image7": null,
        "image8": null,
        "image9": null,
        "image10": null
    },
    "areas": [
        {
            "areaId": 1,
            "metropolitan": "서울",
            "city": "강남/역삼/삼성/논현"
        },
        {
            "areaId": 2,
            "metropolitan": "서울",
            "city": "서초/신사/방배"
        },
        {
            "areaId": 3,
            "metropolitan": "서울",
            "city": "잠실/신천"
        }
    ],
    "unableSchedules": {
        "unableDates": [
            "2023-11-11T00:00:00"
        ]
    },
    "sns": {
        "homepage": "https://happysnap.com",
        "instagram": "happysnap_",
        "kakaoChannel": "https://pf.kakao.com/_happySNAP",
        "twitter": "happysnap_",
        "naverBlog": "https://blog.naver.com"
    },
    "specialList": {
        "keywords": [
            "FRIEND"
        ]
    },
    "tags": {
        "tag1": "친구",
        "tag2": "추억",
        "tag3": "몽환적"
    }  
}

사진 작가 목록 조회

지역, 전문분야, 가능일자를 조건으로 사진 작가 목록을 조회합니다.
기본, 가격 낮은 순, 별점 높은 순, 리뷰 많은 순 정렬을 사용할 수 있습니다.
한 페이지에 15개 반환됩니다.
Method: GET
URI: /photographers
Query Parameter (선택)
- areaId (지역 id, 숫자)
- special (전문분야, 문자)
- ableDate (가능일자, yyyy-MM-ddTHH:mm:ss)
- sort (정렬, PAY / SCORE / REVIEW) - 선택 안 할 시 기본 정렬
- page (페이지, 숫자 | 첫번째 페이지=0, 두번째 페이지=1, ...) - 선택 안 할 시 첫번째 페이지
Request Body

Success Response

URI: /photographers
HTTP Status Code: 200 OK

[
    {
        "photographerId": 1,
        "nickname": "sunnasdfy",          
        "lowestPay": null,
        "image": null,
        "areas": [],
        "specialList": {
            "keywords": [
                "FAMILY"
            ]
        },
        "tags": {
            "tag1": null,
            "tag2": null,
            "tag3": null
        }
    },
    {
        "photographerId": 2,
        "nickname": "sunnasrtdfgdfy",
        "lowestPay": null,
        "image": null,
        "areas": [],
        "specialList": {
            "keywords": [
                "FAMILY"
            ]
        },
        "tags": {
            "tag1": null,
            "tag2": null,
            "tag3": null
        }
    },
    "..." 
]

Success Response

URI: /photographers?areaId=1&special=WEDDING&ableDate=2023-11-01T00:00:00
HTTP Status Code: 200 OK

[
    {
        "photographerId": 5,
        "nickname": "서니서니",
        "lowestPay": 5000,
        "image": "https://test.image3.com",
        "areas": [
            {
                "areaId": 1,
                "metropolitan": "서울",
                "city": "강남/역삼/삼성/논현"
            },
            {
                "areaId": 2,
                "metropolitan": "서울",
                "city": "서초/신사/방배"
            },
            {
                "areaId": 3,
                "metropolitan": "서울",
                "city": "잠실/신천"
            }
        ],
        "specialList": {
            "keywords": [
                "WEDDING"
            ]
        },
        "tags": {
            "tag1": "웅냥",
            "tag2": "발랄",
            "tag3": "짱귀"
        }
    },
    {
        "photographerId": 24,
        "nickname": "이해연",
        "lowestPay": 250000,
        "image": "https://images.unsplash.com/photo-1537633552985-df8429e8048b?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Njd8fCVFQyU5QiVBOCVFQiU5NCVBOSUyMCVFQiU4RiU5OSVFQyU5NiU5MXxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
        "areas": [
            {
                "areaId": 1,
                "metropolitan": "서울",
                "city": "강남/역삼/삼성/논현"
            },
            {
                "areaId": 2,
                "metropolitan": "서울",
                "city": "서초/신사/방배"
            },
            {
                "areaId": 3,
                "metropolitan": "서울",
                "city": "잠실/신천"
            },
            {
                "areaId": 4,
                "metropolitan": "서울",
                "city": "여의도/당산/문래"
            },
            {
                "areaId": 24,
                "metropolitan": "경기",
                "city": "수원 인계"
            },
            {
                "areaId": 25,
                "metropolitan": "경기",
                "city": "수원역/구운/행궁/장안구"
            },
            {
                "areaId": 26,
                "metropolitan": "경기",
                "city": "수원시청/권선/영통/세류"
            },
            {
                "areaId": 27,
                "metropolitan": "경기",
                "city": "안양/평촌/인덕원/과천"
            }
        ],
        "specialList": {
            "keywords": [
                "WEDDING",
                "FAMILY"
            ]
        },
        "tags": {
            "tag1": "부부",
            "tag2": "가족",
            "tag3": "사랑"
        }
    }
]

검색어로 사진 작가 목록 조회

검색어에 해당하는 이름을 가지고 있거나, 검색어에 해당하는 지역에서 활동하는 사진 작가 목록을 조회합니다.
Method: GET
URI: /photographers/search?keyword={keyword}
Query Parameter
- keyword (검색어, 문자 및 숫자)
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "nicknameResult": [
        {
            "photographerId": 5,
            "nickname": "서니서니",
            "lowestPay": 5000,
            "image": "https://test.image3.com",
            "areas": [
                {
                    "areaId": 1,
                    "metropolitan": "서울",
                    "city": "강남/역삼/삼성/논현"
                },
                {
                    "areaId": 2,
                    "metropolitan": "서울",
                    "city": "서초/신사/방배"
                },
                {
                    "areaId": 3,
                    "metropolitan": "서울",
                    "city": "잠실/신천"
                }
            ],
            "specialList": {
                "keywords": [
                    "WEDDING"
                ]  
            },
            "tags": {
                "tag1": "웅냥",
                "tag2": "발랄",
                "tag3": "짱귀"
            }
        }
    ],
    "areaResult": []
}

사진 작가 이름 목록 조회

모든 사진 작가 이름을 조회합니다.
Method: GET
URI: /photographers/name
Request Body

Success Response

HTTP Status Code: 200 OK

[
    {
        "photographerId": 1,
        "nickname": "sunnasdfy"
    },
    {
        "photographerId": 2,
        "nickname": "sunnasrtdfgdfy"
    },
    {
        "photographerId": 3,
        "nickname": "sunnasrtdfgdfy"
    },
    {
        "photographerId": 4,
        "nickname": "sunnasrtdfgdfy"
    },
    {
        "photographerId": 5,
        "nickname": "서니서니"
    },
    "..."
]

Spot

스팟 개별 조회

스팟 하나를 조회합니다.
Method: GET
URI: /spots/{spotId}
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "spotId": 1,
    "name": "2012_비보이 R16 Korea",
    "address": "서울 송파구 올림픽공원 올림픽홀",
    "theme": null,
    "images": []
}

지역으로 스팟 목록 조회

지역을 기준으로 스팟을 목록 조회합니다.
Method: GET
URI: /spots/area
Request Body
```
{
    "areaId" : 17
}
```

Success Response

HTTP Status Code: 200 OK

[
    {
        "spotId": 7,
        "name": "9.81 파크",
        "address": "제주특별자치도 제주시 애월읍",
        "theme": null,
        "images": []
    },
    {
        "spotId": 11,
        "name": "애월 구엄리 돌염전",
        "address": "제주특별자치도 제주시 애월읍",
        "theme": null,
        "images": []
    }
]

스팟 이미지 개별 조회

스팟 이미지를 하나 조회합니다.
Method: GET
URI: /images/{imageId}
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "imageId": 1,
    "spot": {
        "spotId": 1,
        "area": {
            "areaId": 1,
            "metropolitan": "서울",
            "city": "강남/역삼/삼성/논현"
        },
        "name": "2012_비보이 R16 Korea",
        "address": "서울 송파구 올림픽공원 올림픽홀",
        "theme": null
    },
    "image": null
}

지역 개별 조회

지역 하나를 조회합니다.
Method: GET
URI: /areas/{areaId}
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "areaId": 1,
    "metropolitan": "서울",
    "city": "강남/역삼/삼성/논현"
}

Plan

사진 촬영 예약 개별 조회

촬영 예약 개별 조회 기능입니다.
Method: GET
URI: /plans/{planId}
Request Body
Headers: Authorization(필수) Body:

  {
    "planId": "18ad30a9-3fec-4013-b192-cf7252a42d26",
    "customer": 7,
    "photographer": 1,
    "planDate": "2023-09-15T12:30:00",
    "category": "COUPLE",
    "people": 2,
    "wishPlace": "한강공원",
    "request": "잘 부탁드립니다!",
    "price": null,
    "placeName": null,
    "placeAddress": null,
    "status": "DELIVERY",
    "messages": [
        {
            "messageId": 1,
            "isMine": true,
            "sender": "MEMBER",
            "contents": "hey"
        },
        {
            "messageId": 2,
            "isMine": true,
            "sender": "MEMBER",
            "contents": "hey"
        },
        {
            "messageId": 3,
            "isMine": true,
            "sender": "MEMBER",
            "contents": "hey"
        },
        {
            "messageId": 4,
            "isMine": false,
            "sender": "PHOTOGRAPHER",
            "contents": "hey"
        },
        {
            "messageId": 5,
            "isMine": false,
            "sender": "PHOTOGRAPHER",
            "contents": "나는야 사진작가"
        }
    ]
  }

작가 촬영 요청 목록 조회

고객이 자신의 예약 내역을 모두 조회합니다.
Method: GET
URI: /plans/photographer/client
Request Body
Headers: Authorization

{
    "request": [
        {
            "planId": "3bdb4bbb-fa41-49dd-a600-8d27eefb222b",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "55db891e-cb1f-439a-bbc9-81eef74fcb30",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "63e57713-dfa7-4020-8b50-4c1b71f37f49",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "a837aae4-8fcf-4b52-b022-f752d987fd4f",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "cfd4d397-43f1-4c80-93cd-cbf21f716cc5",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "ddf82a29-7a15-49e3-ab7f-80afa9610227",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "de054f04-e875-4596-8348-f55a6ba73108",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        },
        {
            "planId": "f1079490-792d-4a61-97a2-21291c846831",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T12:30:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "REQUEST"
        }
    ],
    "reserved": [
        {
            "planId": "5c510b42-a682-4f94-9854-2ba0942530e7",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T00:00:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "TODAY"
        },
        {
            "planId": "67abe74e-208c-4f8d-b995-05baac263062",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T00:00:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "TODAY"
        },
        {
            "planId": "b1649bec-20f3-4424-b3b7-c8d9aca97ca2",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T00:00:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "TODAY"
        },
        {
            "planId": "f8328bf9-9f99-4576-950f-09c8203f8a00",
            "customer": 7,
            "photographer": 1,
            "planDate": "2023-09-15T00:00:00",
            "category": "COUPLE",
            "people": 2,
            "wishPlace": "한강공원",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "COMPLETE"
        }
    ]
}

고객 예약 내역 조회

고객이 자신의 예약 내역을 모두 조회합니다.
Method: GET
URI: /plans/member
Request Body
Headers: Authorization
Success Response
HTTP Status Code: 200 OK

사진 작가 예약 내역 조회

사진 작가가 자신의 예약 내역을 모두 조회합니다.
Method: GET
URI: /plans/photographer
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

[
  {
        "planId": "57351f46-e6b7-4fd6-b826-174a71a71284",
        "customer": 25,
        "photographer": 14,
        "planDate": "2022-11-10 12:30",
        "category": "COUPLE",
        "people": 2,
        "wishPlace": "한강공원",
        "request": "잘 부탁드립니다!",
        "status": "RESERVED"
    },
    "..."
]

스냅 사진 촬영 예약 신청

고객이 사진 작가에게 스냅 사진 촬영 예약을 신청합니다.
Method: POST
URI: /plans

Request Body
Headers: Authorization

{
    "photographerId" : 19,
    "planDate" : "2022-11-01T14:00:00",
    "time" : "12:30",
    "category" : "FRIEND",
    "people" : 4,
    "wishPlace" : "이화여자대학교",
    "request" : "잘 부탁드립니다!"
}

Success Response

HTTP Status Code: 201 Created

{
    "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
    "customer": 21,
    "photographer": 19,
    "planDate": "2022-11-01T14:00:00",
    "category": "FRIEND",
    "people": 4,
    "time" : "12:30",
    "wishPlace": "이화여자대학교",
    "price": null,
    "request": "잘 부탁드립니다!",
    "status": "REQUEST"
}

스냅 사진 촬영 예약 거절 및 취소

사진 작가가 신청된 스냅 사진 촬영 예약을 거절 및 취소합니다.
Method: PUT
URI: /plans/refuse

Request Body
Headers: Authorization

{
    "planId" : "57351f46-e6b7-4fd6-b826-174a71a71284",
    "contents" : "안녕하세요^^ 진심을 담아 자연스러운 모습을 담아내는 해피스냅입니다. 신청해주신 날은 다른 일정이 있어서 촬영이 어려울 것 같아요ㅜㅜ 혹시 11월 15일이나 17일은 어떠신가요? 날짜 괜찮으시다면 다시 예약 신청 부탁드립니다! 좋은 하루 보내세요~ 감사합니다^^"
}

Success Response

HTTP Status Code: 200 OK

{
    "status": 200,
    "code": "OK",
    "message": "스냅 사진 촬영 예약 거절 및 취소",
    "details": "사진 작가가 스냅 사진 촬영 예약을 거절했습니다."
}

스냅 사진 촬영 비용 입금 요청

사진 작가가 고객에게 스냅 사진 촬영 비용 입금을 요청합니다.
Method: PUT
URI: /plans/deposit

Request Body
Headers: Authorization

{
    "planId" : "57351f46-e6b7-4fd6-b826-174a71a71284",
    "price" : 120000,
    "placeName" : "여의도 한강공원",
    "placeAddress" : "서울특별시 영등포구 여의동로 330",
    "message" : "입금 계좌는 국민은행 1234-5678입니다."
}

Success Response

HTTP Status Code: 200 OK

{
    "planId": "57351f46-e6b7-4fd6-b826-174a71a71284",
    "customer": 25,
    "photographer": 14,
    "planDate": "2022-11-10 12:30",
    "category": "COUPLE",
    "people": 2,
    "wishPlace": "한강공원",
    "time" : "12:30",
    "request": "잘 부탁드립니다!",
    "price": 120000,
    "placeName": "여의도 한강공원",
    "placeAddress": "서울특별시 영등포구 여의동로 330",
    "message": "입금 계좌는 국민은행 1234-5678입니다.",
    "status": "DEPOSIT"
}

스냅 사진 촬영 예약 완료

사진 작가가 촬영 비용 입금을 확인하고 예약 일정을 확정하여 예약을 완료합니다.
Method: PUT
URI: /plans/reserve

Request Body
Headers: Authorization

{
    "planId" : "57351f46-e6b7-4fd6-b826-174a71a71284",
    "contents" : "입금 확인되었습니다. 촬영 시 소품은 자유롭게 사용 가능합니다! 촬영일에 뵙겠습니다^^"
}

Success Response

HTTP Status Code: 200 OK

{
    "status": 200,
    "code": "OK",
    "message": "스냅 사진 예약이 완료되었습니다.",
    "details": "사진 작가가 촬영에 대한 입금을 확인했고, 촬영 일정을 픽스했습니다."
}

스냅 사진 촬영 일정 취소

사진 작가 또는 고객이 스냅 사진 촬영 일정을 취소합니다.
Method: PUT
URI: /plans/cancel

Request Body
Headers: Authorization

{
    "planId" : "57351f46-e6b7-4fd6-b826-174a71a71284",
    "reason" : "개인 일정",
    "refundAccount" : "신한은행 2222-4444"
}

Success Response

HTTP Status Code: 200 OK

{
    "status": 200,
    "code": "OK",
    "message": "스냅 사진 촬영 일정을 취소했습니다.",
    "details": "사진 작가 혹은 일반 고객이 스냅 사진 촬영 일정을 취소했습니다."
}

스냅 사진 파일 전달

사진 작가가 고객에게 스냅 사진 파일을 전달합니다.
Method: PUT
URI: /plans/delivery
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

{
    "status": 200,
    "code": "OK",
    "message": "스냅 사진 파일을 전달했습니다.",
    "details": "사진 작가가 스냅 사진을 전달했습니다."
}

Review

리뷰 작성

고객이 리뷰를 작성합니다.
Method: POST
URI: /reviews

Request Body
Headers: Authorization

{
    "planId" : "f2ce844d-1b18-480f-ac78-548818e5c417",
    "score" : 5,
    "title" : "인생사진 찍었어요!",
    "comment" : "작가님 덕분에 친구들과 좋은 추억 만들었어요~ 예쁘게 찍어주셔서 감사합니다!",
    "image" : "tourlover.jpg"
}

Success Response

HTTP Status Code: 201 Created

{
    "status": 201,
    "code": "CREATED",
    "message": "리뷰가 등록되었습니다.",
    "details": null
}

사진 작가의 리뷰 조회

사진 작가별 리뷰를 조회합니다.
Method: GET
URI: /reviews/photographer/{photographerId}
Request Body

Success Response

HTTP Status Code: 200 OK

{
    "photographer": {
        "member": {
            "email": "[email protected]",
            "nickname": "행복스냅",
            "profile": "https://test.profile.com",
            "role": "ROLE_PHOTOGRAPHER"
        },
        "photographerId": 19,
        "lowestPay": 100000,
        "paymentImage": "https://test.payment.com",
        "bio": "자연스러운 모습을 담아드려요",
        "images": {
            "image1": "https://test.image1.com",
            "image2": "https://test.image2.com",
            "image3": "https://test.image3.com",
            "image4": "https://test.image4.com",
            "image5": "https://test.image5.com",
            "image6": null,
            "image7": null,
            "image8": null,
            "image9": null,
            "image10": null
        },
        "areas": [
            {
                "areaId": 1,
                "metropolitan": "서울",
                "city": "강남/역삼/삼성/논현"
            },
            {
                "areaId": 2,
                "metropolitan": "서울",
                "city": "서초/신사/방배"
            },
            {
                "areaId": 3,
                "metropolitan": "서울",
                "city": "잠실/신천"
           }
        ],
        "unableSchedules": {
            "unableDates": [
                "2023-11-11T00:00:00"
            ]
        },
        "sns": {
            "homepage": "https://happysnap.com",
            "instagram": "happysnap_",
            "kakaoChannel": "https://pf.kakao.com/_happySNAP",
            "twitter": "happysnap_",
            "naverBlog": "https://blog.naver.com"
        },
        "specialList": {
            "keywords": [
                "FRIEND"
            ]
        },
        "tags": {
            "tag1": "친구",
            "tag2": "추억",
            "tag3": "몽환적"
        }
    },
    "totalReview": 4,
    "averageScore": 4.5,
    "reviews": [
        {
            "reviewId": 7,
            "plan": {
                "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
                "customer": 21,
                "photographer": 19,
                "planDate": "2022-11-01T14:00:00",
                "category": "FRIEND",
                "people": 4,
                "wishPlace": "이화여자대학교",
                "price": null,
                "request": "잘 부탁드립니다!",
                "status": "DELIVERY"
            },
            "score": 5,
            "image": "snap.jpg",
            "title": "멋진 사진 감사해요",
            "comment": "사진 너무 예쁘네요~ 감사합니다"
        },
        {
            "reviewId": 8,
            "plan": {
                "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
                "customer": 21,
                "photographer": 19,
                "planDate": "2022-11-01T14:00:00",
                "category": "FRIEND",
                "people": 4,
                "wishPlace": "이화여자대학교",
                "price": null,
                "request": "잘 부탁드립니다!",
                "status": "DELIVERY"
            },
            "score": 5,
            "image": "tourlover.jpg",
            "title": "인생사진 찍었어요!",
            "comment": "작가님 덕분에 친구들과 좋은 추억 만들었어요~ 예쁘게 찍어주셔서 감사합니다!"
        },  
        {
            "reviewId": 6,
            "plan": {
                "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
                "customer": 21,
                "photographer": 19,
                "planDate": "2022-11-01T14:00:00",
                "category": "FRIEND",
                "people": 4,
                "wishPlace": "이화여자대학교",
                "price": null,
                "request": "잘 부탁드립니다!",
                "status": "DELIVERY"
            },
            "score": 4,
            "image": "",
            "title": "",
            "comment": ""
        },
        {
            "reviewId": 5,
            "plan": {
                "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
                "customer": 21,
                "photographer": 19,
                "planDate": "2022-11-01T14:00:00",
                "category": "FRIEND",
                "people": 4,
                "wishPlace": "이화여자대학교",
                "price": null,
                "request": "잘 부탁드립니다!",
                "status": "DELIVERY"
            },
            "score": 3,
            "image": "",
            "title": "",
            "comment": ""
        }
    ]
}

일반 고객의 리뷰 조회

사용자가 작성한 리뷰를 전체조회합니다.
Method: GET
URI: /reviews/member
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

[
    {
        "reviewId": 7,
        "plan": {
            "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
            "customer": 21,
            "photographer": 19,
            "planDate": "2022-11-01T14:00:00",
            "category": "FRIEND",
            "people": 4,
            "wishPlace": "이화여자대학교",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "DELIVERY"
        },
        "score": 5,
        "image": "snap.jpg",
        "title": "멋진 사진 감사해요",
        "comment": "사진 너무 예쁘네요~ 감사합니다"
    },
    {
        "reviewId": 8,
        "plan": {
            "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
            "customer": 21,
            "photographer": 19,
            "planDate": "2022-11-01T14:00:00",
            "category": "FRIEND",
            "people": 4,
            "wishPlace": "이화여자대학교",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "DELIVERY"
        },
        "score": 5,
        "image": "tourlover.jpg",
        "title": "인생사진 찍었어요!",
        "comment": "작가님 덕분에 친구들과 좋은 추억 만들었어요~ 예쁘게 찍어주셔서 감사합니다!"
    },
    {
        "reviewId": 6,
        "plan": {
            "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
            "customer": 21,
            "photographer": 19,
            "planDate": "2022-11-01T14:00:00",
            "category": "FRIEND",
            "people": 4,
            "wishPlace": "이화여자대학교",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "DELIVERY"
        },
        "score": 4,
        "image": "",
        "title": "",
        "comment": ""
    },
    {
        "reviewId": 5,
        "plan": {
            "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
            "customer": 21,
            "photographer": 19,
            "planDate": "2022-11-01T14:00:00",
            "category": "FRIEND",
            "people": 4,
            "wishPlace": "이화여자대학교",
            "price": null,
            "request": "잘 부탁드립니다!",
            "status": "DELIVERY"
        },
        "score": 3,
        "image": "",
        "title": "",
        "comment": ""
    }  
]

Message

Heart

좋아요 생성

좋아하는 작가의 ID를 body로 받아서 좋아요를 생성합니다.
Method: POST
URI: /hearts
Request Body
```
{
    "photographerId" : 23
}
```

Success Response

HTTP Status Code: 201 Created

{
    "heartId": 4,
    "memberName": "yeji",
    "photographerName": "강지석",
    "message": "좋아요를 눌렀습니다."
}

좋아요 취소

좋아요를 눌렀던 작가의 ID를 body로 받아서 좋아요를 취소합니다.
Method: DELETE
URI: /hearts
Request Body
```
{
    "photographerId" : 23
}
```

Success Response

HTTP Status Code: 200 OK

{
    "memberName": "yeji",
    "photographerName": "강지석",
    "message": "좋아요를 취소했습니다."
}

좋아요 모아보기

좋아요 누른 작가들을 조회합니다.
Method: GET
URI: /hearts
Request Body

Success Response

HTTP Status Code: 200 OK

[
    {
        "photographerId": 21,
        "nickname": "한나라",
        "lowestPay": 120000,
        "image": "https://images.unsplash.com/photo-1536010305525-f7aa0834e2c7?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTEyfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
        "areas": [],
        "specialList": {
            "keywords": [
                "FRIEND"
            ]
        },
        "tags": {
            "tag1": "아련",
            "tag2": "낭만",
            "tag3": "몽환적"
        }
    },
    {
        "photographerId": 22,
        "nickname": "유진아",
        "lowestPay": 100000,
        "image": "https://images.unsplash.com/photo-1541339907198-e08756dedf3f?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8ODR8fCVFQyVBMSVCOCVFQyU5NyU4NSVFQyU4QSVBNCVFQiU4MyU4NXxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
        "areas": [
            {
                "areaId": 5,
                "metropolitan": "서울",
                "city": "신림/서울대/사당/동작"
            },
            {
                "areaId": 9,
                "metropolitan": "서울",
                "city": "신촌/홍대/합정/연남"
            },
            {
                "areaId": 12,
                "metropolitan": "서울",
                "city": "종로/대학로/동묘"
            },
            {
                "areaId": 13,
                "metropolitan": "서울",
                "city": "성신여대/성북/월곡"
            },
            {
                "areaId": 14,
                "metropolitan": "서울",
                "city": "이태원/용산/서울역"
            },
            {
                "areaId": 18,
                "metropolitan": "서울",
                "city": "회기/고려대/청량리/신설동"
            },
            {
                "areaId": 20,
                "metropolitan": "서울",
                "city": "왕십리/성수/금호"
            },
            {
                "areaId": 22,
                "metropolitan": "서울",
                "city": "상봉/중랑/면목"
            },
            {
                "areaId": 23,
                "metropolitan": "서울",
                "city": "태릉/노원/도봉/창동"
            }
        ],
        "specialList": {
            "keywords": [
                "FRIEND",
                "GRADUATION"
            ]
        },
        "tags": {
            "tag1": "우정",
            "tag2": "청춘",
            "tag3": "행복"
        }
    },
    {
        "photographerId": 23,
        "nickname": "강지석",
        "lowestPay": 200000,
        "image": "https://images.unsplash.com/photo-1603367563698-67012943fd67?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Njh8fCVFQSVCMCU4MCVFQyVBMSVCMSVFQyU4MiVBQyVFQyVBNyU4NHxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
        "areas": [],
        "specialList": {
            "keywords": [
                "FAMILY"
            ]
        },
        "tags": {
            "tag1": "가족",
            "tag2": "사랑",
            "tag3": "행복"
        }
    }
]

Snap Photo

베스트 스냅사진 등록

고객이 베스트 스냅사진을 등록합니다.
Method: POST
URI: /photos

Request Body
Headers: Authorization

{
    "imageUrl" : "http://image.co.kr",
    "photoDate" : "2023-09-10T20:32:00",
    "location" : "서울시 마포구 우리집",
    "photographerId" : 25,
    "tag1" : "tag1",
    "tag2" : "tag2",
    "tag3" : "tag3"
}

Success Response

HTTP Status Code: 201 Created

{
    "snapPhotoId": 1,
    "imageUrl": "http://image.co.kr",
    "photoDate": "2023-09-10T20:32:00",
    "location": "서울시 마포구 우리집",
    "photographerId": 25,
    "photographerName": "사진작가예지",
    "tag1": "tag1",
    "tag2": "tag2",
    "tag3": "tag3"
}

베스트 스냅사진 모아보기

고객이 등록한 베스트 스냅사진들을 조회합니다.
한 페이지에 6개 반환됩니다.
Method: GET
URI: /photos
Query Parameter (선택)
- page (페이지, 숫자 | 첫번째 페이지=0, 두번째 페이지=1, ...) - 선택 안 할 시 첫번째 페이지
Request Body
Headers: Authorization

Success Response

HTTP Status Code: 200 OK

[
    {
        "snapPhotoId": 1,
        "imageUrl": "http://image.co.kr",
        "photoDate": "2023-09-10T20:32:00",
        "location": "서울시 마포구 우리집",
        "photographerId": 25,
        "photographerName": "사진작가예지",
        "tag1": "tag1",
        "tag2": "tag2",
        "tag3": "tag3"
    },
    {
        "snapPhotoId": 2,
        "imageUrl": "http://image.com",
        "photoDate": "2023-09-21T00:16:00",
        "location": "서울시 마포구 중동동",
        "photographerId": 25,
        "photographerName": "사진작가예지",
        "tag1": "태그1",
        "tag2": "태그2",
        "tag3": "태그그3"
    }
]

SnapSpot API

Auth

일반 회원가입

일반 로그인

카카오 회원가입

카카오 로그인

Member

고객 계정 정보 조회

고객 계정 정보 수정

Photographer

사진 작가 계정 정보 조회

사진 작가 계정 정보 수정

사진 작가 프로필 수정 (작가 페이지 커스텀)

사진 작가 개별 조회

사진 작가 목록 조회

검색어로 사진 작가 목록 조회

사진 작가 이름 목록 조회

Spot

스팟 개별 조회

지역으로 스팟 목록 조회

스팟 이미지 개별 조회

지역 개별 조회

Plan

사진 촬영 예약 개별 조회

작가 촬영 요청 목록 조회

고객 예약 내역 조회

사진 작가 예약 내역 조회

스냅 사진 촬영 예약 신청

스냅 사진 촬영 예약 거절 및 취소

스냅 사진 촬영 비용 입금 요청

스냅 사진 촬영 예약 완료

스냅 사진 촬영 일정 취소

스냅 사진 파일 전달

Review

리뷰 작성

사진 작가의 리뷰 조회

일반 고객의 리뷰 조회

Message

Heart

좋아요 생성

좋아요 취소

좋아요 모아보기

Snap Photo

베스트 스냅사진 등록

베스트 스냅사진 모아보기

Clone this wiki locally