관리자 가게 상세 조회

GET /admins/stores/{storeId}

권한: MANAGER

관리자가 특정 가게의 상세 정보를 조회합니다.

Path Parameters

Table 1. /admins/stores/{storeId}
Parameter Description

storeId

가게 UUID

HTTP Request Example

GET /admins/stores/26e50b8b-69f5-486c-a68e-32142c3a36df?_csrf=puheLz5WjICCkR1Y1NNhUEXBI_gCVdZ4nuu4_A32icgoodOpw9tvTQdgubmvpnxs5P5VYyGnDsA3YeBVqo6Jmm_Eu_hMk7eb HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

status

String

HTTP 상태

message

String

응답 메시지

timestamp

String

응답 타임스탬프

data.storeId

String

가게 UUID

data.storeName

String

가게 이름

data.phoneNumber

String

가게 전화번호

data.businessNumber

String

사업자 등록 번호

data.description

String

가게 상세 설명

data.reviewCount

Number

총 리뷰 수

data.avgRating

Number

평균 별점

data.storeStatus

String

가게 운영 상태 (OPEN, CLOSED)

data.address.sidoName

String

시/도 명칭

data.address.sigunguName

String

시/군/구 명칭

data.address.dongName

String

법정동/읍/면 명칭

data.address.roadAddress

String

도로명 주소

data.address.detailAddress

String

상세 주소

data.address.sidoCode

String

시/도 코드

data.address.sigunguCode

String

시/군/구 코드

data.address.dongCode

String

법정동 코드

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 739

{
  "code" : "ST202",
  "status" : "OK",
  "message" : "가게 정보 수정 성공",
  "data" : {
    "storeId" : "39f9504a-d0fc-4165-a20a-3fb116be3d7c",
    "storeName" : "감자네 치킨",
    "phoneNumber" : "02-1234-5678",
    "businessNumber" : "123-45-67890",
    "description" : "맛있는 치킨집입니다.",
    "reviewCount" : 10,
    "avgRating" : 4.5,
    "storeStatus" : "OPEN",
    "address" : {
      "sidoCode" : "11",
      "sidoName" : "서울특별시",
      "sigunguCode" : "110",
      "sigunguName" : "강남구",
      "dongCode" : "11010",
      "dongName" : "역삼동",
      "roadAddress" : "테헤란로 427",
      "detailAddress" : "위워크"
    }
  },
  "timestamp" : "2026-03-11T10:10:09.757837641"
}

관리자 가게 정보 수정

PATCH /admins/stores/{storeId}

권한: MANAGER

관리자가 가게 정보를 수정합니다.

Path Parameters

Table 2. /admins/stores/{storeId}
Parameter Description

storeId

수정할 가게 UUID

Request Fields

Path Type Description

storeCategoryId

String

카테고리 UUID

storeName

String

수정할 가게 이름

storePhone

String

가게 전화번호

description

String

가게 설명

address

Object

가게 주소

address.sidoCode

String

시도 코드

address.sidoName

String

시도 이름

address.sigunguCode

String

시군구 코드

address.sigunguName

String

시군구 이름

address.dongCode

String

동 코드

address.dongName

String

동 이름

address.roadAddress

String

도로명 주소

address.detailAddress

String

상세 주소

HTTP Request Example

PATCH /admins/stores/4758ab8d-551b-4c7b-8ee3-5cf019881191?_csrf=HVyQyC2LcHhdu47Vq25fcYEkUUXzTxGfS4PQppkC-hC1ck1_KDj0_RjtEkFw2byzmUNrF-IRfCfBLiKyebTgwqgynyjTE35K HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 448
Host: localhost:8080

{
  "storeCategoryId" : "a6f5070c-0458-49e7-bbf3-78345a90d43e",
  "storeName" : "수정된 가게명",
  "storePhone" : "02-1111-2222",
  "address" : {
    "sidoCode" : "11",
    "sidoName" : "서울특별시",
    "sigunguCode" : "110",
    "sigunguName" : "강남구",
    "dongCode" : "11010",
    "dongName" : "역삼동",
    "roadAddress" : "테헤란로 427",
    "detailAddress" : "위워크"
  },
  "description" : "가게 설명 수정"
}

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data

Null

응답 데이터 (null)

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 152

{
  "code" : "ST202",
  "status" : "OK",
  "message" : "가게 정보 수정 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:09.795847376"
}

관리자 가게 상태 수정

PATCH /admins/stores/{storeId}/status

권한: MANAGER

관리자가 가게의 영업 상태를 변경합니다.

Path Parameters

Table 3. /admins/stores/{storeId}/status
Parameter Description

storeId

가게 UUID

Request Fields

Path Type Description

status

String

변경할 상태 (true: 영업중, false: 준비중)

HTTP Request Example

PATCH /admins/stores/58de7e9a-f8fa-4965-a084-85f8e95d8f31/status?_csrf=6HapFOp5GQLW2ZjEH1iNVbyt5Q-5XF-VNBrT0oCwVa17HJZH2kLNJN9OejX74P71JnW5MdrOyG3bZT24Ui22sLHUN55KJad0 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 28
Host: localhost:8080

{
  "status" : "SUSPENDED"
}

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data

Null

응답 데이터 (null)

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 159

{
  "code" : "ST203",
  "status" : "OK",
  "message" : "가게 영업 상태 변경 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:09.817146747"
}

관리자 가게 삭제

DELETE /admins/stores/{storeId}

권한: MANAGER

관리자가 가게를 삭제합니다.

Path Parameters

Table 4. /admins/stores/{storeId}
Parameter Description

storeId

삭제할 가게 UUID

HTTP Request Example

DELETE /admins/stores/8f3e395b-d85f-4cc7-a638-ca33b5bdafe8 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: localhost:8080
Content-Length: 102

_csrf=iETKy5gKV7TdzTpV-0I2Gy5hV03prHpYtEpr6P1qfO1oGf98unKu-6o6ZIbw-Qxknm8CeUhVei_bnhl1gi8K0MpZSYtZIZ5I

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data

Null

응답 데이터 (null)

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 145

{
  "code" : "ST204",
  "status" : "OK",
  "message" : "가게 삭제 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:09.349910224"
}