활성 카테고리 목록 조회

GET /store-categories

권한: CUSTOMER, OWNER, MANAGER

현재 활성화된 가게 카테고리 목록을 조회합니다.

HTTP Request Example

GET /store-categories HTTP/1.1
Content-Type: application/json
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data.storeCategoryList[].id

String

카테고리 UUID

data.storeCategoryList[].name

String

카테고리 이름

data.totalCount

Number

총 개수

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 303

{
  "code" : "SC200",
  "status" : "OK",
  "message" : "가게 카테고리 목록 조회 성공",
  "data" : {
    "storeCategoryList" : [ {
      "id" : "8562c651-5314-4297-add3-e4f2b6cc7faa",
      "name" : "한식"
    } ],
    "totalCount" : 0
  },
  "timestamp" : "2026-03-11T10:10:10.386979655"
}

카테고리 상세 조회

GET /store-categories/{storeCategoryId}

권한: MANAGER

특정 카테고리의 상세 정보 및 감사 정보를 조회합니다.

Path Parameters

Table 1. /store-categories/{storeCategoryId}
Parameter Description

storeCategoryId

카테고리 UUID

HTTP Request Example

GET /store-categories/8562c651-5314-4297-add3-e4f2b6cc7faa HTTP/1.1
Content-Type: application/json
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data.id

String

카테고리 UUID

data.name

String

카테고리 이름

data.description

String

카테고리 이름

data.auditInfo.createdBy

String

생성자 UUID

data.auditInfo.createdAt

String

생성일시

data.auditInfo.updatedBy

String

수정자 UUID

data.auditInfo.updatedAt

String

수정일시

data.auditInfo.deletedBy

Null

삭제자 UUID

data.auditInfo.deletedAt

Null

삭제일시

HTTP Response Example

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 573

{
  "code" : "SC201",
  "status" : "OK",
  "message" : "가게 카테고리 상세 조회 성공",
  "data" : {
    "id" : "8562c651-5314-4297-add3-e4f2b6cc7faa",
    "name" : "한식",
    "description" : "설명",
    "auditInfo" : {
      "createdBy" : "fb9b98c1-9a2b-4de7-af2d-a788721d1a4b",
      "createdAt" : "2026-03-11T19:10:10.356542169",
      "updatedBy" : "fb9b98c1-9a2b-4de7-af2d-a788721d1a4b",
      "updatedAt" : "2026-03-11T19:10:10.356542169",
      "deletedBy" : null,
      "deletedAt" : null
    }
  },
  "timestamp" : "2026-03-11T10:10:10.359650349"
}

카테고리 생성

POST /store-categories

권한: MANAGER

새로운 가게 카테고리를 생성합니다.

Request Fields

Path Type Description

name

String

생성할 카테고리 이름

description

String

생성할 카테고리 설명

HTTP Request Example

POST /store-categories?_csrf=rGlBxLiSaq3PGsRvgfdpYnr-Bj_WoV_-6Hx0zMPOWwZSyMkeyg9wpt2rWpziKv0L4tpdWh_IK12zw2jT2hlN9PSsOGQ2-v8q HTTP/1.1
Content-Type: application/json
Content-Length: 51
Host: localhost:8080

{
  "name" : "중식",
  "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
Content-Length: 163

{
  "code" : "SC202",
  "status" : "CREATED",
  "message" : "가게 카테고리 생성 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:10.376858996"
}

카테고리 수정

PATCH /store-categories/{storeCategoryId}

권한: MANAGER

기존 가게 카테고리의 이름 및 설명을 수정합니다.

Path Parameters

Table 2. /store-categories/{storeCategoryId}
Parameter Description

storeCategoryId

수정할 카테고리 UUID

Request Fields

Path Type Description

name

String

생성할 카테고리 이름

description

String

생성할 카테고리 설명

HTTP Request Example

PATCH /store-categories/8562c651-5314-4297-add3-e4f2b6cc7faa?_csrf=Y1Lum8-nC6WC_8Re5i9UF8VhFka0YZf8JrIQEqVSNuLM0DRIVWHXqauRM8evnvI41wJgcadSO3-CBfHREYVyJpVjVNv14gMs HTTP/1.1
Content-Type: application/json
Content-Length: 51
Host: localhost:8080

{
  "name" : "일식",
  "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
Content-Length: 158

{
  "code" : "SC203",
  "status" : "OK",
  "message" : "가게 카테고리 수정 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:10.275619718"
}

카테고리 삭제

DELETE /store-categories/{storeCategoryId}

권한: MANAGER

가게 카테고리를 삭제합니다.

Path Parameters

Table 3. /store-categories/{storeCategoryId}
Parameter Description

storeCategoryId

삭제할 카테고리 UUID

HTTP Request Example

DELETE /store-categories/8562c651-5314-4297-add3-e4f2b6cc7faa HTTP/1.1
Content-Type: application/json
Host: localhost:8080

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
Content-Length: 157

{
  "code" : "SC204",
  "status" : "OK",
  "message" : "가게 카테고리 삭제 성공",
  "data" : null,
  "timestamp" : "2026-03-11T10:10:10.28979829"
}