허용 지역 목록 조회

GET /allowed-regions

권한: MANAGER

커서 기반 페이지네이션으로 허용 지역 목록을 조회합니다.

Query Parameters

Parameter Description

lastId

마지막 커서 ID (UUID)

sortType

정렬 타입 (LATEST / SIDO_NAME / ACTIVE, 기본값: ACTIVE)

lastCreatedAt

마지막 생성일시 (LATEST / ACTIVE 정렬 시)

lastSidoName

마지막 시도 이름 (SIDO_NAME 정렬 시)

lastSigunguName

마지막 시군구 이름 (SIDO_NAME 정렬 시)

lastIsActive

마지막 활성화 여부 (ACTIVE 정렬 시)

sidoCode

시도 코드 필터

activeFilter

활성화 여부 필터 (true / false)

size

페이지 크기 (기본값 10)

HTTP Request Example

GET /allowed-regions?size=10 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data.hasNext

Boolean

다음 페이지 존재 여부

data.allowedRegionCount

Number

현재 페이지 지역 수

data.lastCursorId

String

마지막 커서 ID

data.allowedRegions[].allowedRegionId

String

허용 지역 UUID

data.allowedRegions[].sidoCode

String

시도 코드

data.allowedRegions[].sidoName

String

시도 이름

data.allowedRegions[].sigunguCode

String

시군구 코드

data.allowedRegions[].sigunguName

String

시군구 이름

data.allowedRegions[].isActive

Boolean

활성화 여부

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: 528

{
  "code" : "AR200",
  "status" : "OK",
  "message" : "허용 지역 목록 조회 성공",
  "data" : {
    "hasNext" : false,
    "allowedRegionCount" : 1,
    "lastCursorId" : "c233cd3f-c776-4e59-9e63-cf5bd841fb26",
    "allowedRegions" : [ {
      "allowedRegionId" : "c233cd3f-c776-4e59-9e63-cf5bd841fb26",
      "sidoCode" : "11",
      "sidoName" : "서울특별시",
      "sigunguCode" : "11010",
      "sigunguName" : "종로구",
      "isActive" : true
    } ]
  },
  "timestamp" : "2026-03-11T10:09:51.644319613"
}

허용 지역 등록

POST /allowed-regions

권한: MANAGER

새로운 허용 지역을 등록합니다. 이미 등록된 시군구 코드는 등록할 수 없습니다.

Request Fields

Path Type Description

sidoCode

String

시도 코드

sidoName

String

시도 이름

sigunguCode

String

시군구 코드

sigunguName

String

시군구 이름

HTTP Request Example

POST /allowed-regions?_csrf=gXD43A1hrT78_IeZPfcpRz7VcjmN5gGDUZ0zTvHRbHvn73G8sxbPvTwFlAfRmuX8W9odcwzhXwC0hDiuZq1QdpXkCkzf3kTf HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 115
Host: localhost:8080

{
  "sidoCode" : "11",
  "sidoName" : "서울특별시",
  "sigunguCode" : "11010",
  "sigunguName" : "종로구"
}

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data.allowedRegionId

String

생성된 허용 지역 UUID

data.sidoCode

String

시도 코드

data.sidoName

String

시도 이름

data.sigunguCode

String

시군구 코드

data.sigunguName

String

시군구 이름

data.isActive

Boolean

활성화 여부

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: 365

{
  "code" : "AR201",
  "status" : "CREATED",
  "message" : "허용 지역 생성 성공",
  "data" : {
    "allowedRegionId" : "c233cd3f-c776-4e59-9e63-cf5bd841fb26",
    "sidoCode" : "11",
    "sidoName" : "서울특별시",
    "sigunguCode" : "11010",
    "sigunguName" : "종로구",
    "isActive" : true
  },
  "timestamp" : "2026-03-11T10:09:51.695474853"
}

허용 지역 활성화/비활성화 토글

PATCH /allowed-regions/{allowedRegionId}/activation?activation={activation}

권한: MANAGER

허용 지역의 활성화 상태를 변경합니다. 비활성화된 지역은 주문 시 허용 지역으로 인식되지 않습니다.

Path Parameters

Table 1. /allowed-regions/{allowedRegionId}/activation
Parameter Description

allowedRegionId

허용 지역 UUID

Query Parameters

Parameter Description

activation

활성화 여부 (true: 활성화, false: 비활성화)

HTTP Request Example

PATCH /allowed-regions/c233cd3f-c776-4e59-9e63-cf5bd841fb26/activation?activation=true HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

message

String

응답 메시지

status

String

HTTP 상태

timestamp

String

응답 타임스탬프

data.allowedRegionId

String

허용 지역 UUID

data.sidoCode

String

시도 코드

data.sidoName

String

시도 이름

data.sigunguCode

String

시군구 코드

data.sigunguName

String

시군구 이름

data.isActive

Boolean

변경된 활성화 여부

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: 377

{
  "code" : "AR202",
  "status" : "OK",
  "message" : "허용 지역 활성화 상태 변경 성공",
  "data" : {
    "allowedRegionId" : "c233cd3f-c776-4e59-9e63-cf5bd841fb26",
    "sidoCode" : "11",
    "sidoName" : "서울특별시",
    "sigunguCode" : "11010",
    "sigunguName" : "종로구",
    "isActive" : true
  },
  "timestamp" : "2026-03-11T10:09:51.549052155"
}