Skip to content

โœ… Photographer

YEJI edited this page Sep 25, 2023 · 3 revisions

SUMMARY

URI Description
๐Ÿ“Œ GET /photographers/me ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋งˆ์ดํŽ˜์ด์ง€ ์กฐํšŒ
๐Ÿ“Œ PUT /photographers/setting ์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ณ„์ • ์ •๋ณด ์ˆ˜์ •
๐Ÿ“Œ PUT /photographers/me ์‚ฌ์ง„ ์ž‘๊ฐ€ ํŽ˜์ด์ง€ ์ปค์Šคํ…€
๐Ÿ“Œ GET /photographers/{photographerId} ์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ฐœ๋ณ„ ์กฐํšŒ
GET /photographers ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋ชฉ๋ก ์กฐํšŒ
GET /photographers/search?keyword={keyword} ์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ฒ€์ƒ‰
GET /photographers/name ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ด๋ฆ„ ๋ชฉ๋ก ์กฐํšŒ

๐Ÿ“Œ ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋งˆ์ดํŽ˜์ด์ง€ ์กฐํšŒ GET /photographers/me

๐Ÿ“Œ Request Parameters

  • Headers: Authorization

Response Parameters

Field Type Description
member email, nickname, profile, role๋กœ ๊ตฌ์„ฑ
email string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ด๋ฉ”์ผ
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„
profile string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ํ”„๋กœํ•„ ์‚ฌ์ง„
role string ROLE_PHOTOGRAPHER
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
lowestPay Long ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ตœ์ € ๊ฐ€๊ฒฉ
paymentImage string ๊ฐ€๊ฒฉํ‘œ ์ด๋ฏธ์ง€
bio string ์‚ฌ์ง„ ์ž‘๊ฐ€ ์†Œ๊ฐœ
images ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€. ์ตœ๋Œ€ 10๊ฐœ / image1~image10์œผ๋กœ ๊ตฌ์„ฑ
areas ์‚ฌ์ง„ ์ž‘๊ฐ€ ํ™œ๋™ ์ง€์—ญ ๋ฆฌ์ŠคํŠธ / areaId, metropolitan, city๋กœ ๊ตฌ์„ฑ
areaId Long ์ง€์—ญ ID
metropolitan string ์ง€์—ญ ๋Œ€๋ถ„๋ฅ˜
city string ์ง€์—ญ ์†Œ๋ถ„๋ฅ˜
unableSchedules ๋ถˆ๊ฐ€ ์Šค์ผ€์ค„ ๋ฆฌ์ŠคํŠธ / unableDates๋กœ ๊ตฌ์„ฑ
unableDates LocalDateTime ๋ถˆ๊ฐ€ ๋‚ ์งœ. yyyy-MM-ddThh:mm:ss
sns sns ๋ฆฌ์ŠคํŠธ / hompage, instagram, kakaoChannel, twitter, naverBlog๋กœ ๊ตฌ์„ฑ
specialList ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ / keywords๋กœ ๊ตฌ์„ฑ
keywords ENUM COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tags ์‚ฌ์ง„ ์ž‘๊ฐ€ ํƒœ๊ทธ ๋ฆฌ์ŠคํŠธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
review ๋ฆฌ๋ทฐ ๊ด€๋ จ / totalReview, averageScore, reviews๋กœ ๊ตฌ์„ฑ
totalReview Integer ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ๊ฐœ์ˆ˜
averageScore Double ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ํ‰๊ท  ๋ณ„์ 
reviews ๋ฆฌ๋ทฐ ๋ฆฌ์ŠคํŠธ / reviewId, plan, score, image, title, comment๋กœ ๊ตฌ์„ฑ
reviewId Long ๋ฆฌ๋ทฐ ID
plan ์˜ˆ์•ฝ ๊ด€๋ จ
score Integer ๋ณ„์ 
image string ํ›„๊ธฐ ์‚ฌ์ง„
title string ๋ฆฌ๋ทฐ ์ œ๋ชฉ
comment string ๋ฆฌ๋ทฐ ํ‰

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

Response

{
    "member": {
        "email": "[email protected]",
        "nickname": "์‚ฌ์ง„์ž‘๊ฐ€์˜ˆ์ง€",
        "profile": "http://ewha.com/ewha",
        "role": "ROLE_PHOTOGRAPHER"
    },
    "photographerId": 21,
    "lowestPay": 100000,
    "paymentImage": "https://www.kkday.com/ko/blog/wp-content/uploads/graduation_campus_photography_promotion.jpg",
    "bio": "๊ฐœ์ธ์Šค๋ƒ…๊ณผ ์šฐ์ •์Šค๋ƒ…์„ ๋‚ญ๋งŒ์ ์ธ ๋Š๋‚Œ์œผ๋กœ ์ฐ์–ด๋“œ๋ฆฝ๋‹ˆ๋‹ค",
    "images": {
        "image1": "https://images.unsplash.com/photo-1536010305525-f7aa0834e2c7?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTEyfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
        "image2": "https://images.unsplash.com/photo-1475823678248-624fc6f85785?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8NHx8JUVEJTk1JTlDJUVBJUI1JUFEJTIwJUVDJTk3JUFDJUVDJTg0JUIxfGVufDB8fDB8fHww&auto=format&fit=crop&w=500&q=60",
        "image3": "https://images.unsplash.com/photo-1505200063777-4a0b90b007c8?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8NXx8JUVEJTk1JTlDJUVBJUI1JUFEJTIwJUVDJTk3JUFDJUVDJTg0JUIxfGVufDB8fDB8fHww&auto=format&fit=crop&w=500&q=60",
        "image4": "https://images.unsplash.com/photo-1556159916-26bf2ce06da9?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Mjd8fCVFRCU5NSU5QyVFQSVCNSVBRCUyMCVFQyU5NyVBQyVFQyU4NCVCMXxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
        "image5": "https://images.unsplash.com/photo-1669557465701-bc21f2c83d81?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTAzfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
        "image6": "https://images.unsplash.com/photo-1669557465702-f589e964fbc0?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTE0fHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
        "image7": "https://images.unsplash.com/photo-1520512571425-be5116940a2c?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTIxfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
        "image8": null,
        "image9": null,
        "image10": null
    },
    "areas": [],
    "unableSchedules": {
        "unableDates": [
            "2023-10-06T00:00:00",
            "2023-10-20T00:00:00"
        ]
    },
    "sns": {
        "homepage": "https://naraphoto.com",
        "instagram": "naraphoto",
        "kakaoChannel": "https://pf.kakao.com/narasnap",
        "twitter": "",
        "naverBlog": ""
    },
    "specialList": {
        "keywords": [
            "FRIEND"
        ]
    },
    "tags": {
        "tag1": "์•„๋ จ",
        "tag2": "๋‚ญ๋งŒ",
        "tag3": "๋ชฝํ™˜์ "
    },
    "review": {
        "totalReview": 0,
        "averageScore": "NaN",
        "reviews": [
            {
                "reviewId": 7,
                "plan": {
                    "planId": "f2ce844d-1b18-480f-ac78-548818e5c417",
                    "customer": {
                        "email": "[email protected]",
                        "nickname": "traveler",
                        "profile": null,
                        "role": "ROLE_MEMBER"
                    },
                    "photographer": {
                        "email": "[email protected]",
                        "nickname": "ํ–‰๋ณต์Šค๋ƒ…",
                        "profile": "https://test.profile.com",
                        "role": "ROLE_PHOTOGRAPHER"
                    },
                    "planDate": "2022-11-05T15:00:00",
                    "time": "12:30",
                    "category": "FRIEND",
                    "people": 6,
                    "wishPlace": "์ดํ™”์—ฌ์ž๋Œ€ํ•™๊ต",
                    "price": null,
                    "request": "์ž˜ ๋ถ€ํƒ๋“œ๋ฆฝ๋‹ˆ๋‹ค!",
                    "status": "REQUEST"
                },
                "score": 5,
                "image": "snap.jpg",
                "title": "๋ฉ‹์ง„ ์‚ฌ์ง„ ๊ฐ์‚ฌํ•ด์š”",
                "comment": "์‚ฌ์ง„ ๋„ˆ๋ฌด ์˜ˆ์˜๋„ค์š”~ ๊ฐ์‚ฌํ•ฉ๋‹ˆ๋‹ค"
            }
        ]
    }
}

๐Ÿ“Œ ์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ณ„์ • ์ •๋ณด ์ˆ˜์ • PUT /photographers/setting

๐Ÿ“Œ Request Parameters

  • Headers: Authorization
Field Type Description
nickname string ๋ณ€๊ฒฝํ•  ๋‹‰๋„ค์ž„
profileImage string ๋ณ€๊ฒฝํ•  ํ”„๋กœํ•„ ์‚ฌ์ง„ URL
email string ๋ณ€๊ฒฝํ•  ์ด๋ฉ”์ผ
password string ์‚ฌ์šฉ์ž์˜ ๋น„๋ฐ€๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜์ง€ ์•Š์œผ๋ฉด 500 ์—๋Ÿฌ ๋ฐœ์ƒ

Response Parameters

Field Type Description
nickname string ๋ณ€๊ฒฝ๋œ ๋‹‰๋„ค์ž„
profile string ๋ณ€๊ฒฝ๋œ ํ”„๋กœํ•„ ์‚ฌ์ง„ URL
email string ๋ณ€๊ฒฝ๋œ ์ด๋ฉ”์ผ
role string ROLE_PHOTOGRAPHER

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

{
    "nickname" : "์‚ฌ์ง„์ž‘๊ฐ€์˜ˆ์ง€",
    "profileImage" : "http://ewha.com/ewha",
    "email" : "[email protected]",
    "password" : "kimyeji"
}

Response

{
    "email": "[email protected]",
    "nickname": "์‚ฌ์ง„์ž‘๊ฐ€์˜ˆ์ง€",
    "profile": "http://ewha.com/ewha",
    "role": "ROLE_PHOTOGRAPHER"
}

๐Ÿ“Œ ์‚ฌ์ง„ ์ž‘๊ฐ€ ํŽ˜์ด์ง€ ์ปค์Šคํ…€ PUT /photographers/me

๐Ÿ“Œ Request Parameters

  • Headers: Authorization
Field Type Description
nickname string ๋‹‰๋„ค์ž„
profileImage string ํ”„๋กœํ•„ ์‚ฌ์ง„ URL
paymentImage string ๊ฐ€๊ฒฉํ‘œ ์ด๋ฏธ์ง€
lowestPay string ์ตœ์ € ๊ฐ€๊ฒฉ
bio string ์†Œ๊ฐœ
areaId Long ์ž‘๊ฐ€์˜ ํ™œ๋™ ์ง€์—ญ. ์—ฌ๋Ÿฌ ๊ฐœ ์ž…๋ ฅ ๊ฐ€๋Šฅ
sns sns / hompage, instagram, kakaoChannel, twitter, naverBlog๋กœ ๊ตฌ์„ฑ
instagram string ์ธ์Šคํƒ€๊ทธ๋žจ ๊ณ„์ •
twitter string ํŠธ์œ„ํ„ฐ ๊ณ„์ •
kakaoChannel string ์นด์นด์˜คํ†ก ์ฑ„๋„
naverBlog string ๋„ค์ด๋ฒ„ ๋ธ”๋กœ๊ทธ ์ฃผ์†Œ
homepage string ํ™ˆํŽ˜์ด์ง€ ์ฃผ์†Œ
specialList string ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ. ์—ฌ๋Ÿฌ ๊ฐœ ์ž…๋ ฅ ๊ฐ€๋Šฅ / COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tag ํƒœ๊ทธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
tag1 string ํƒœ๊ทธ 1
unableDates LocalDateTime ๋ถˆ๊ฐ€ ๋‚ ์งœ ๋ฆฌ์ŠคํŠธ. ์—ฌ๋Ÿฌ ๊ฐœ ์ž…๋ ฅ ๊ฐ€๋Šฅ / yyyy-MM-ddThh:mm:ss
image ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€. ์ตœ๋Œ€ 10๊ฐœ / image1~image10์œผ๋กœ ๊ตฌ์„ฑ
image1 string ์ด๋ฏธ์ง€ 1

Response Parameters

Field Type Description
member email, nickname, profile, role๋กœ ๊ตฌ์„ฑ
email string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ด๋ฉ”์ผ
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„
profile string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ํ”„๋กœํ•„ ์‚ฌ์ง„
role string ROLE_PHOTOGRAPHER
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
lowestPay Long ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ตœ์ € ๊ฐ€๊ฒฉ
paymentImage string ๊ฐ€๊ฒฉํ‘œ ์ด๋ฏธ์ง€
bio string ์‚ฌ์ง„ ์ž‘๊ฐ€ ์†Œ๊ฐœ
images ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€. ์ตœ๋Œ€ 10๊ฐœ / image1~image10์œผ๋กœ ๊ตฌ์„ฑ
areas ์‚ฌ์ง„ ์ž‘๊ฐ€ ํ™œ๋™ ์ง€์—ญ ๋ฆฌ์ŠคํŠธ / areaId, metropolitan, city๋กœ ๊ตฌ์„ฑ
areaId Long ์ง€์—ญ ID
metropolitan string ์ง€์—ญ ๋Œ€๋ถ„๋ฅ˜
city string ์ง€์—ญ ์†Œ๋ถ„๋ฅ˜
unableSchedules ๋ถˆ๊ฐ€ ์Šค์ผ€์ค„ ๋ฆฌ์ŠคํŠธ / unableDates๋กœ ๊ตฌ์„ฑ
unableDates LocalDateTime ๋ถˆ๊ฐ€ ๋‚ ์งœ. yyyy-MM-ddThh:mm:ss
sns sns ๋ฆฌ์ŠคํŠธ / hompage, instagram, kakaoChannel, twitter, naverBlog๋กœ ๊ตฌ์„ฑ
specialList ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ / keywords๋กœ ๊ตฌ์„ฑ
keywords ENUM COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tags ์‚ฌ์ง„ ์ž‘๊ฐ€ ํƒœ๊ทธ ๋ฆฌ์ŠคํŠธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
review ๋ฆฌ๋ทฐ ๊ด€๋ จ / totalReview, averageScore, reviews๋กœ ๊ตฌ์„ฑ
totalReview Integer ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ๊ฐœ์ˆ˜
averageScore Double ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ํ‰๊ท  ๋ณ„์ 
reviews ๋ฆฌ๋ทฐ ๋ฆฌ์ŠคํŠธ / reviewId, plan, score, image, title, comment๋กœ ๊ตฌ์„ฑ
reviewId Long ๋ฆฌ๋ทฐ ID
plan ์˜ˆ์•ฝ ๊ด€๋ จ
score Integer ๋ณ„์ 
image string ํ›„๊ธฐ ์‚ฌ์ง„
title string ๋ฆฌ๋ทฐ ์ œ๋ชฉ
comment string ๋ฆฌ๋ทฐ ํ‰

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

{
    "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"
    }
}

Response

{
    "member": {
        "email": "[email protected]",
        "nickname": "ํ–‰๋ณต์Šค๋ƒ…",
        "profile": "https://test.profile.com",
        "role": "ROLE_PHOTOGRAPHER"
    },
    "photographerId": 25,
    "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": []
    },
    "sns": {
        "homepage": "https://happysnap.com",
        "instagram": "happysnap_",
        "kakaoChannel": "https://pf.kakao.com/_happySNAP",
        "twitter": "happysnap_",
        "naverBlog": "https://blog.naver.com"
    },
    "specialList": {
        "keywords": []
    },
    "tags": {
        "tag1": "์นœ๊ตฌ",
        "tag2": "์ถ”์–ต",
        "tag3": "๋ชฝํ™˜์ "
    },
    "review": {
        "totalReview": 0,
        "averageScore": "NaN",
        "reviews": []
    }
}

๐Ÿ“Œ ์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ฐœ๋ณ„ ์กฐํšŒ GET /photographers/{photographerId}

๐Ÿ“Œ Request Parameters

  • Headers: Authorization

Response Parameters

Field Type Description
photograher ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ •๋ณด
member email, nickname, profile, role๋กœ ๊ตฌ์„ฑ
email string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ด๋ฉ”์ผ
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„
profile string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ํ”„๋กœํ•„ ์‚ฌ์ง„
role string ROLE_PHOTOGRAPHER
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
lowestPay Long ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ตœ์ € ๊ฐ€๊ฒฉ
paymentImage string ๊ฐ€๊ฒฉํ‘œ ์ด๋ฏธ์ง€
bio string ์‚ฌ์ง„ ์ž‘๊ฐ€ ์†Œ๊ฐœ
images ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€. ์ตœ๋Œ€ 10๊ฐœ / image1~image10์œผ๋กœ ๊ตฌ์„ฑ
areas ์‚ฌ์ง„ ์ž‘๊ฐ€ ํ™œ๋™ ์ง€์—ญ ๋ฆฌ์ŠคํŠธ / areaId, metropolitan, city๋กœ ๊ตฌ์„ฑ
areaId Long ์ง€์—ญ ID
metropolitan string ์ง€์—ญ ๋Œ€๋ถ„๋ฅ˜
city string ์ง€์—ญ ์†Œ๋ถ„๋ฅ˜
unableSchedules ๋ถˆ๊ฐ€ ์Šค์ผ€์ค„ ๋ฆฌ์ŠคํŠธ / unableDates๋กœ ๊ตฌ์„ฑ
unableDates LocalDateTime ๋ถˆ๊ฐ€ ๋‚ ์งœ. yyyy-MM-ddThh:mm:ss
sns sns ๋ฆฌ์ŠคํŠธ / hompage, instagram, kakaoChannel, twitter, naverBlog๋กœ ๊ตฌ์„ฑ
specialList ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ / keywords๋กœ ๊ตฌ์„ฑ
keywords ENUM COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tags ์‚ฌ์ง„ ์ž‘๊ฐ€ ํƒœ๊ทธ ๋ฆฌ์ŠคํŠธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
review ๋ฆฌ๋ทฐ ๊ด€๋ จ / totalReview, averageScore, reviews๋กœ ๊ตฌ์„ฑ
totalReview Integer ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ๊ฐœ์ˆ˜
averageScore Double ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ํ‰๊ท  ๋ณ„์ 
reviews ๋ฆฌ๋ทฐ ๋ฆฌ์ŠคํŠธ / reviewId, plan, score, image, title, comment๋กœ ๊ตฌ์„ฑ
reviewId Long ๋ฆฌ๋ทฐ ID
plan ์˜ˆ์•ฝ ๊ด€๋ จ
score Integer ๋ณ„์ 
image string ํ›„๊ธฐ ์‚ฌ์ง„
title string ๋ฆฌ๋ทฐ ์ œ๋ชฉ
comment string ๋ฆฌ๋ทฐ ํ‰
isLiked boolean ๊ณ ๊ฐ์ด ์ข‹์•„์š”๋ฅผ ๋ˆŒ๋ €๋Š”์ง€ ์—ฌ๋ถ€

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

Response

{
    "photographer": {
        "member": {
            "email": "[email protected]",
            "nickname": "ํ•œ๋‚˜๋ผ",
            "profile": "https://images.unsplash.com/photo-1635353866477-f77a828b431a?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTd8fCVFRCU5NSU5QyVFQSVCNSVBRCUyMCVFQyU5NyVBQyVFQyU4NCVCMXxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
            "role": "ROLE_PHOTOGRAPHER"
        },
        "photographerId": 21,
        "lowestPay": 120000,
        "paymentImage": "https://www.kkday.com/ko/blog/wp-content/uploads/graduation_campus_photography_promotion.jpg",
        "bio": "๊ฐœ์ธ์Šค๋ƒ…๊ณผ ์šฐ์ •์Šค๋ƒ…์„ ๋‚ญ๋งŒ์ ์ธ ๋Š๋‚Œ์œผ๋กœ ์ฐ์–ด๋“œ๋ฆฝ๋‹ˆ๋‹ค",
        "images": {
            "image1": "https://images.unsplash.com/photo-1536010305525-f7aa0834e2c7?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTEyfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
            "image2": "https://images.unsplash.com/photo-1475823678248-624fc6f85785?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8NHx8JUVEJTk1JTlDJUVBJUI1JUFEJTIwJUVDJTk3JUFDJUVDJTg0JUIxfGVufDB8fDB8fHww&auto=format&fit=crop&w=500&q=60",
            "image3": "https://images.unsplash.com/photo-1505200063777-4a0b90b007c8?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8NXx8JUVEJTk1JTlDJUVBJUI1JUFEJTIwJUVDJTk3JUFDJUVDJTg0JUIxfGVufDB8fDB8fHww&auto=format&fit=crop&w=500&q=60",
            "image4": "https://images.unsplash.com/photo-1556159916-26bf2ce06da9?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Mjd8fCVFRCU5NSU5QyVFQSVCNSVBRCUyMCVFQyU5NyVBQyVFQyU4NCVCMXxlbnwwfHwwfHx8MA%3D%3D&auto=format&fit=crop&w=500&q=60",
            "image5": "https://images.unsplash.com/photo-1669557465701-bc21f2c83d81?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTAzfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
            "image6": "https://images.unsplash.com/photo-1669557465702-f589e964fbc0?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTE0fHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
            "image7": "https://images.unsplash.com/photo-1520512571425-be5116940a2c?ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8MTIxfHwlRUQlOTUlOUMlRUElQjUlQUQlMjAlRUMlOTclQUMlRUMlODQlQjF8ZW58MHx8MHx8fDA%3D&auto=format&fit=crop&w=500&q=60",
            "image8": null,
            "image9": null,
            "image10": null
        },
        "areas": [],
        "unableSchedules": {
            "unableDates": [
                "2023-10-06T00:00:00",
                "2023-10-20T00:00:00"
            ]
        },
        "sns": {
            "homepage": "https://naraphoto.com",
            "instagram": "naraphoto",
            "kakaoChannel": "https://pf.kakao.com/narasnap",
            "twitter": "",
            "naverBlog": ""
        },
        "specialList": {
            "keywords": [
                "FRIEND"
            ]
        },
        "tags": {
            "tag1": "์•„๋ จ",
            "tag2": "๋‚ญ๋งŒ",
            "tag3": "๋ชฝํ™˜์ "
        },
        "review": {
            "totalReview": 0,
            "averageScore": "NaN",
            "reviews": []
        }
    },
    "isLiked": true
}

์‚ฌ์ง„ ์ž‘๊ฐ€ ๋ชฉ๋ก ์กฐํšŒ GET /photographers?areaId={areaId}&special={special}&ableDate={date}&sort={sort}

Request Parameters

  • areaId: Long
  • special: COUPLE(์ปคํ”Œ์Šค๋ƒ…), FREIND(์šฐ์ •์Šค๋ƒ…), GRADUATION(์กธ์—…์Šค๋ƒ…), WEDDING(์›จ๋”ฉ์Šค๋ƒ…), FAMILY(๊ฐ€์กฑ์Šค๋ƒ…), ETC(๊ธฐํƒ€)
  • date: yyyy-MM-ddThh:mm:ss
  • sort: REVIEW(๋ฆฌ๋ทฐ ๋งŽ์€ ์ˆœ ์ •๋ ฌ), SCORE(๋ณ„์  ๋†’์€ ์ˆœ ์ •๋ ฌ), PAY(๊ฐ€๊ฒฉ ๋‚ฎ์€ ์ˆœ ์ •๋ ฌ)

Response Parameters - List

Field Type Description
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„
lowestPay Long ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ตœ์ € ๊ฐ€๊ฒฉ
image string ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ 1๊ฐœ
areas ์‚ฌ์ง„ ์ž‘๊ฐ€ ํ™œ๋™ ์ง€์—ญ ๋ฆฌ์ŠคํŠธ / areaId, metropolitan, city๋กœ ๊ตฌ์„ฑ
areaId Long ์ง€์—ญ ID
metropolitan string ์ง€์—ญ ๋Œ€๋ถ„๋ฅ˜
city string ์ง€์—ญ ์†Œ๋ถ„๋ฅ˜
specialList ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ / keywords๋กœ ๊ตฌ์„ฑ
keywords ENUM COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tags ์‚ฌ์ง„ ์ž‘๊ฐ€ ํƒœ๊ทธ ๋ฆฌ์ŠคํŠธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
totalReview Integer ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ๊ฐœ์ˆ˜
averageScore Double ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ํ‰๊ท  ๋ณ„์ 

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

Response

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

์‚ฌ์ง„ ์ž‘๊ฐ€ ๊ฒ€์ƒ‰ GET /photographers/search?keyword={keyword}

Request Parameters

  • keyword: string

Response Parameters - List

Field Type Description
nicknameResult ๊ฒ€์ƒ‰์–ด๋ฅผ ๋‹‰๋„ค์ž„์œผ๋กœ ๊ฐ–๋Š” ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋ฆฌ์ŠคํŠธ
areaResult ๊ฒ€์ƒ‰์–ด์— ํ•ด๋‹นํ•˜๋Š” ์ง€์—ญ์—์„œ ํ™œ๋™ํ•˜๋Š” ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋ฆฌ์ŠคํŠธ
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„
lowestPay Long ์‚ฌ์ง„์ž‘๊ฐ€์˜ ์ตœ์ € ๊ฐ€๊ฒฉ
image string ์‚ฌ์ง„ ์ž‘๊ฐ€ ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ 1๊ฐœ
areas ์‚ฌ์ง„ ์ž‘๊ฐ€ ํ™œ๋™ ์ง€์—ญ ๋ฆฌ์ŠคํŠธ / areaId, metropolitan, city๋กœ ๊ตฌ์„ฑ
areaId Long ์ง€์—ญ ID
metropolitan string ์ง€์—ญ ๋Œ€๋ถ„๋ฅ˜
city string ์ง€์—ญ ์†Œ๋ถ„๋ฅ˜
specialList ์‚ฌ์ง„ ์ž‘๊ฐ€ ์ „๋ฌธ๋ถ„์•ผ ๋ฆฌ์ŠคํŠธ / keywords๋กœ ๊ตฌ์„ฑ
keywords ENUM COUPLE ์ปคํ”Œ์Šค๋ƒ…, FREIND ์šฐ์ •์Šค๋ƒ…, GRADUATION ์กธ์—…์Šค๋ƒ…, WEDDING ์›จ๋”ฉ์Šค๋ƒ…, FAMILY ๊ฐ€์กฑ์Šค๋ƒ…, ETC ๊ธฐํƒ€
tags ์‚ฌ์ง„ ์ž‘๊ฐ€ ํƒœ๊ทธ ๋ฆฌ์ŠคํŠธ / tag1, tag2, tag3๋กœ ๊ตฌ์„ฑ
totalReview Integer ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ๊ฐœ์ˆ˜
averageScore Double ์‚ฌ์ง„ ์ž‘๊ฐ€์˜ ๋ฆฌ๋ทฐ ํ‰๊ท  ๋ณ„์ 

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

Response

{
    "nicknameResult": [
        {
            "photographerId": 5,
            "nickname": "์„œ๋‹ˆ์„œ๋‹ˆ",
            "lowestPay": 100000,
            "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": "์งฑ๊ท€"
            },
            "totalReview": 0,
            "averageScore": "NaN"
        }
    ],
    "areaResult": [],
    "recommend": null
}

์‚ฌ์ง„ ์ž‘๊ฐ€ ์ด๋ฆ„ ๋ชฉ๋ก ์กฐํšŒ GET /photographers/name

Request Parameters

Response Parameters - List

Field Type Description
photographerId Long ์‚ฌ์ง„์ž‘๊ฐ€ ID
nickname string ์‚ฌ์ง„์ž‘๊ฐ€์˜ ๋‹‰๋„ค์ž„

์˜ˆ์‹œ ์š”์ฒญ/์‘๋‹ต
๐Ÿ“Œ Request

Response

[
    {
        "photographerId": 1,
        "nickname": "abc"
    },
    {
        "photographerId": 2,
        "nickname": "photo"
    },
    {
        "photographerId": 3,
        "nickname": "photo1"
    },
    ...
]
Clone this wiki locally