Shop API

지점(상점) 관련 API

키워드로 지점 조회

키워드로 지점 조회

GET https://www.photosmap.site/shops

키워드에 해당하는 지점을 조회한다

Query Parameters

Name	Type	Description
keyword*	String	사용자가 입력한 조회 키워드 (지역명 또는 지역명+브랜드 또는 브랜드+지점명으로 사용자에게 가이드라인 제공 필요)
userLat*	Double	사용자 현재위치 위도
userLng*	Double	사용자 현재위치 경도

Headers

Name	Type	Description
Authorization	Bearer	access token

200: OK 성공 (지점 존재하지 않음)

[]

400: Bad Request 실패 (위도, 경도, 키워드 유효하지 않음)

{
    "error_code": "002",
    "error_message": "[keyword] 공백일 수 없습니다."
}

{
    "error_code": "003",
    "error_message": "[keyword] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[userLat] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[userLng] 필수 파라미터가 누락되었습니다."
}

200: OK 성공

[
    {
        "id": 18978,
        "place_name": "인생네컷 서울숙명여대점",
        "longitude": "126.96929602811387",
        "latitude": "37.54450983610701",
        "distance": "83.0km",
        "star_rating_avg": 0.0,
        "review_cnt": 0,
        "favorite_cnt": 0,
        "brand": {
            "brand_name": "인생네컷",
            "file_path": "https://--"
        },
        "place_address": "서울 용산구 청파로45길 24",
        "favorite": false
    },
    {
        "id": 19179,
        "place_name": "포토이즘박스 용리단길점",
        "longitude": "126.972792700771",
        "latitude": "37.5317038756722",
        "distance": "81.6km",
        "star_rating_avg": 0.0,
        "review_cnt": 0,
        "favorite_cnt": 0,
        "brand": {
            "brand_name": "포토이즘",
            "file_path": "https://--"
        },
        "place_address": "서울 용산구 한강대로52길 31",
        "favorite": false
    },
    {
        "id": 19011,
        "place_name": "하루필름 이태원점",
        "longitude": "126.993291900873",
        "latitude": "37.5336953286258",
        "distance": "81.4km",
        "star_rating_avg": 0.0,
        "review_cnt": 0,
        "favorite_cnt": 0,
        "brand": {
            "brand_name": "하루필름",
            "file_path": "https://--"
        },
        "place_address": "서울 용산구 이태원로26길 16",
        "favorite": false
    },
    {
        "id": 19014,
        "place_name": "하루필름 한남점",
        "longitude": "127.00008712037",
        "latitude": "37.535585818848",
        "distance": "81.6km",
        "star_rating_avg": 0.0,
        "review_cnt": 0,
        "favorite_cnt": 0,
        "brand": {
            "brand_name": "하루필름",
            "file_path": "https://--"
        },
        "place_address": "",
        "favorite": false
    },
    {
        "id": 18627,
        "place_name": "인생네컷 서울이태원점",
        "longitude": "126.99311983886",
        "latitude": "37.5346584886863",
        "distance": "81.6km",
        "star_rating_avg": 0.0,
        "review_cnt": 0,
        "favorite_cnt": 0,
        "brand": {
            "brand_name": "인생네컷",
            "file_path": "https://--"
        },
        "place_address": "서울 용산구 이태원로 171",
        "favorite": false
    }
]

반경 내 브랜드 별 지점 조회

반경 내 브랜드 별 지점 조회

GET https://www.photosmap.site/shops/brand

지도 중심 좌표를 기준으로 반경 내에 있는 대표 브랜드 중 하나 혹은 전체 지점을 조회한다.

Query Parameters

Name	Type	Description
userLat*	Double	사용자 현재위치 위도
userLng*	Double	사용자 현재위치 경도
brand	String	하루필름, 인생네컷, 포토이즘, 포토그레이 중 사용자가 요청한 브랜드 -전체 브랜드 조회 시 해당 파라미터 필요 (X)
mapLat*	Double	지도 중심 위도
mapLng*	Double	지도 중심 경도
radius	Integer	제한 반경 (단위: m) -Default : 2000 (2km)

Headers

Name	Type	Description
Authorization	Bearer	access token

200: OK 성공 (지점 존재하지 않음)

[]

200: OK 성공 (전체 브랜드)

{
    "address": "서울특별시 용산구 이태원로2길 16",
    "shops": [
        {
            "id": 19179,
            "place_name": "포토이즘박스 용리단길점",
            "longitude": "126.972792700771",
            "latitude": "37.5317038756722",
            "distance": "450km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "포토이즘",
                "file_path": "https://--"
            },
            "shop_titles": [],
            "favorite": false
        },
        {
            "id": 19036,
            "place_name": "하루필름 용리단길점",
            "longitude": "126.97151423446",
            "latitude": "37.5317378122685",
            "distance": "450km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "하루필름",
                "file_path": "https://--"
            },
            "shop_titles": [],
            "favorite": false
        },
        {
            "id": 18821,
            "place_name": "인생네컷 서울 경리단길점",
            "longitude": "126.98813439409285",
            "latitude": "37.53725297479663",
            "distance": "451km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 3,
            "brand": {
                "brand_name": "인생네컷",
                "file_path": "https://--"
            },
            "shop_titles": [
                "핫플레이스"
            ],
            "favorite": false
        },
        {
            "id": 19301,
            "place_name": "포토이즘박스 해방촌점",
            "longitude": "126.986964896026",
            "latitude": "37.5412821240091",
            "distance": "451km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "포토이즘",
                "file_path": "https://--"
            },
            "shop_titles": [],
            "favorite": false
        },
        {
            "id": 19011,
            "place_name": "하루필름 이태원점",
            "longitude": "126.993291900873",
            "latitude": "37.5336953286258",
            "distance": "451km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "하루필름",
                "file_path": "https://--"
            },
            "shop_titles": [],
            "favorite": false
        }
    ]
}

400: Bad Request 실패 (유효하지 않은 위도, 경도)

{
    "error_code": "003",
    "error_message": "[userLat] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[userLng] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[mapLat] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[mapLng] 필수 파라미터가 누락되었습니다."
}

200: OK 성공 (대표 브랜드 중 택1)

{
    "address": "서울특별시 용산구 이태원로2길 16",
    "shops": [
        {
            "id": 19179,
            "place_name": "포토이즘박스 용리단길점",
            "longitude": "126.972792700771",
            "latitude": "37.5317038756722",
            "distance": "18.0km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "포토이즘",
                "file_path": "https://--"
            },
	    "shop_titles": [],
            "favorite": false
        },
        {
            "id": 19301,
            "place_name": "포토이즘박스 해방촌점",
            "longitude": "126.986964896026",
            "latitude": "37.5412821240091",
            "distance": "19.3km",
            "star_rating_avg": 0.0,
            "review_cnt": 0,
            "favorite_cnt": 0,
            "brand": {
                "brand_name": "포토이즘",
                "file_path": "https://--"
            },
	    "shop_titles": [],
            "favorite": false
        }
    ]
}

지점 상세 조회

지점 상세 조회

GET https://www.photosmap.site/shops/{shop-id}

지점 상세페이지를 조회한다

Query Parameters

Name	Type	Description
userLat	Double	사용자 현재위치 위도
userLng	Double	사용자 현재위치 경도

Headers

Name	Type	Description
Authorization	Bearer	access token

200: OK 성공

{
    "id": 19116,
    "place_name": "하루필름 제주 시청점",
    "distance": "",
    "star_rating_avg": 5.0,
    "review_cnt": 4,
    "favorite_cnt": 4,
    "shop_titles": [
        "핫플레이스",
        "청결한 지점"
    ],
    "latitude": "33.4986348725412",
    "longitude": "126.529854442721",
    "place_url": "http://place.map.kakao.com/1173539401",
    "recent_reviews": [
        {
            "review_info": {
                "id": 186,
                "create_date": [
                    2023,
                    5,
                    17,
                    19,
                    34,
                    13,
                    963901000
                ],
                "modify_date": [
                    2023,
                    5,
                    17,
                    19,
                    34,
                    13,
                    963901000
                ],
                "star_rating": 5,
                "content": "d",
                "purity": "GOOD",
                "retouch": "GOOD",
                "item": "GOOD"
            },
            "member_info": {
                "id": 11,
                "nickname": "ddsss",
                "main_member_title": "뉴비"
            }
        },
        {
            "review_info": {
                "id": 176,
                "create_date": [
                    2023,
                    5,
                    16,
                    22,
                    28,
                    49,
                    723077000
                ],
                "modify_date": [
                    2023,
                    5,
                    16,
                    22,
                    28,
                    49,
                    723077000
                ],
                "star_rating": 5,
                "content": "굿",
                "purity": "GOOD",
                "retouch": "GOOD",
                "item": "GOOD"
            },
            "member_info": {
                "id": 17,
                "nickname": "맨두",
                "main_member_title": "뉴비"
            }
        },
        {
            "review_info": {
                "id": 168,
                "create_date": [
                    2023,
                    5,
                    16,
                    21,
                    32,
                    6,
                    324413000
                ],
                "modify_date": [
                    2023,
                    5,
                    16,
                    21,
                    32,
                    6,
                    324413000
                ],
                "star_rating": 5,
                "content": "깨끗해요",
                "purity": "GOOD",
                "retouch": "UNSELECTED",
                "item": "UNSELECTED"
            },
            "member_info": {
                "id": 15,
                "nickname": "어텐숀",
                "main_member_title": "뉴비"
            }
        }
    ],
    "favorite": false
}

400: Bad Request 실패 (위도, 경도가 유효하지 않음)

{
    "error_code": "003",
    "error_message": "[userLat] 필수 파라미터가 누락되었습니다."
}

{
    "error_code": "003",
    "error_message": "[userLng] 필수 파라미터가 누락되었습니다."
}

400: Bad Request 실패(카카오맵 일치 데이터가 없는 shop-id)

{
    "error_code": "400",
    "error_message": "[id] 도로명주소나 브랜드명 불일치로 카카오맵에서 일치하는 데이터가 없는 id 입니다. 다른 id로 요청해주세요."
}

404: Not Found 실패 (shop-id에 해당하는 지점 존재하지 않음)

{
    "error_code": "404",
    "error_message": "조회한 지점이 존재하지 않습니다."
}