전체 주문 목록 조회

GET /admins/orders

권한: MANAGER

Request Parameters

Unresolved directive in admin-order.adoc - include::/home/runner/work/baedalsodae/baedalsodae/build/generated-snippets/admin-order/get-orders/request-parameters.adoc[]

HTTP Request Example

GET /admins/orders?size=10 HTTP/1.1
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

status

String

HTTP 상태

message

String

응답 메시지

data.orders

Array

주문 목록

data.hasNext

Boolean

다음 페이지 존재 여부

data.nextCursorCreatedAt

Null

다음 페이지 커서 - 기준 생성일시

data.nextCursorId

Null

다음 페이지 커서 - 기준 주문 ID

HTTP Response Example

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
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: 198

{"code":"OR202","status":"OK","message":"주문 목록 조회 성공","data":{"orders":[],"hasNext":false,"nextCursorCreatedAt":null,"nextCursorId":null},"timestamp":"2026-03-11T10:10:05.410264701"}

주문 상세 조회

GET /admins/orders/{orderId}

권한: MANAGER

Path Parameters

Table 1. /admins/orders/{orderId}
Parameter Description

orderId

주문 ID

HTTP Request Example

GET /admins/orders/639371c0-bffb-4214-ad89-7eecd38e16e7 HTTP/1.1
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

status

String

HTTP 상태

message

String

응답 메시지

data.orderId

String

주문 ID

data.orderNo

String

주문 번호

data.userNickname

String

주문자 닉네임

data.userPhone

String

주문자 전화번호

data.storeId

String

가게 ID

data.storeName

String

가게명

data.status

String

주문 상태

data.storeRequestNote

String

가게 요청 사항

data.deliveryRequestNote

String

배달 요청 사항

data.deliveryAddressSnapshot

String

배달 주소

data.totalAmount

Number

총 금액

data.deliveryFee

Number

배달비

data.discountAmount

Number

할인 금액

data.finalAmount

Number

최종 결제 금액

data.items

Array

주문 아이템 목록

data.orderCreatedAt

String

주문 생성일시

data.orderedAt

String

주문 요청일시

HTTP Response Example

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
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: 704

{"code":"OR203","status":"OK","message":"주문 상세 조회 성공","data":{"orderId":"639371c0-bffb-4214-ad89-7eecd38e16e7","orderNo":"ORD-20260310-0001","userNickname":"테스트고객","userPhone":"010-1234-5678","storeId":"cd984bc4-b7f3-42c0-a8b2-77a04977576b","storeName":"테스트 가게","status":"CREATED","storeRequestNote":"요청사항 없음","deliveryRequestNote":"문 앞에 놓아주세요","deliveryAddressSnapshot":"서울특별시 강남구 테헤란로 1","totalAmount":10000,"deliveryFee":3000,"discountAmount":0,"finalAmount":13000,"items":[],"orderCreatedAt":"2026-03-11T10:10:05.37305677","orderedAt":"2026-03-11T10:10:05.373073311"},"timestamp":"2026-03-11T10:10:05.378820742"}

주문 상태 전이 이력 조회

GET /admins/orders/{orderId}/status-history

권한: MANAGER

Path Parameters

Table 2. /admins/orders/{orderId}/status-history
Parameter Description

orderId

주문 ID

HTTP Request Example

GET /admins/orders/27a50c1e-9a0f-49cb-af79-c5c103ac1175/status-history HTTP/1.1
Host: localhost:8080

Response Fields

Path Type Description

code

String

응답 코드

status

String

HTTP 상태

message

String

응답 메시지

data.orderId

String

주문 ID

data.currentStatus

Null

현재 주문 상태

data.histories

Null

상태 전이 이력 목록

HTTP Response Example

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
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: 210

{"code":"OR204","status":"OK","message":"주문 상태 조회 성공","data":{"orderId":"27a50c1e-9a0f-49cb-af79-c5c103ac1175","currentStatus":null,"histories":null},"timestamp":"2026-03-11T10:10:05.464577178"}

주문 취소 대기 요청 (관리자)

POST /admins/orders/{orderId}/cancel-request

권한: MANAGER

  • 취소 불가 상태(CANCELED, CANCEL_REQUESTED)를 제외한 모든 상태에서 취소 요청 가능합니다.

Path Parameters

Table 3. /admins/orders/{orderId}/cancel-request
Parameter Description

orderId

주문 ID

Request Parameters

Unresolved directive in admin-order.adoc - include::/home/runner/work/baedalsodae/baedalsodae/build/generated-snippets/admin-order/cancel-request-order/request-parameters.adoc[]

HTTP Request Example

POST /admins/orders/079dbc1c-70e9-4dc9-88ea-c9929c4982a8/cancel-request HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: localhost:8080
Content-Length: 175

reason=%EA%B4%80%EB%A6%AC%EC%9E%90+%EC%B7%A8%EC%86%8C+%EC%82%AC%EC%9C%A0&_csrf=ozTRZVpR_DADuHvVz5BvI_rvpEZ-mRMiz50N2Kxh9fGxDZcalgToBzxoygYujE2x-b1bFc6MiX8YoCcPrvxvu5tXlMDXaPJ_

Response Fields

Path Type Description

code

String

응답 코드

status

String

HTTP 상태

message

String

응답 메시지

data.orderId

String

주문 ID

data.orderStatus

String

변경된 주문 상태

data.paymentStatus

Null

결제 상태

HTTP Response Example

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
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: 225

{"code":"OR211","status":"OK","message":"주문 취소 요청 성공","data":{"orderId":"079dbc1c-70e9-4dc9-88ea-c9929c4982a8","orderStatus":"CANCEL_REQUESTED","paymentStatus":null},"timestamp":"2026-03-11T10:10:05.44234393"}