이 섹션의 문서

더보기

변경일시 기준 주문내역 조회 (v2)

조회기간 내 신규 생성되거나 변경이 발생한 주문 내역을 제공합니다. 
조회기간은 최대 1일(24시간)이며, 요청별 최대 100개의 주문 내역을 조회할 수 있습니다.

주문내역 최초 조회 후, 추가 조회를 하기 위해서 응답 값에 전달한 lastOrderId(요청별 조회 결과의 마지막 주문ID)와
lastModifiedAt(요청별 조회 결과의 마지막 수정 일시)을 입력해야 합니다. 

lastOrderId와 lastModifiedAt은 추가 주문 내역을 응답할 때마다 달라지며, 
더 이상 조회 가능한 주문 내역이 없는 경우 lastOrderId와 lastModifiedAt을 제공하지 않습니다. 

추가 조회 가능한 주문 내역이 있지만 lastOrderId와 lastModifiedAt을 입력하지 않을 경우 
최초 조회된 주문목록을 응답합니다. 

lastOrderId와 lastModifiedAt 중 하나만 입력한 경우 에러를 반환합니다.

 

 

요청

GET /v2/shopping/orders HTTP/1.1
Content-type: application/json
필드명 타입 필수여부 설명 기본값
size Integer N 요청별 조회할 주문 수
최대 100개씩 조회 가능		 default: 20, max: 100
orderStatus String N 조회할 주문 상태
특정 주문 상태를 입력할 경우, 입력한 주문 상태에 해당하는 주문 정보만 반환		  
orderModifiedAtStart date-time Y 조회 시작 일시 (YYYY-MM-DD HH:mm:ss)
ex) 2025-07-01 23:00:00		  
orderModifiedAtEnd date-time N 조회 종료 일시 (YYYY-MM-DD HH:mm:ss)
ex) 2025-07-01 23:59:59		  
lastOrderId int64 N 추가 주문 내역을 요청하기 위한 응답 결과의 마지막의 주문ID  
lastModifiedAt date-time N 추가 주문 내역을 요청하기 위한 응답 결과의 마지막의 주문일시  

본 문서는 API v2 기준이며, 일부 필드명이 v1과 다르니 사용 시 유의해 주세요~

 

응답

필드 타입 설명
orderId int64 주문 ID
paymentId int64 결제 ID
orderStatus string 주문 상태
createdAt datetime 주문 생성일시
modifiedAt datetime 주문 최종 수정일시
paidAt datetime 주문 결제일시
deliveryRequestAt datetime 배송 요청 일시
ticketAcceptedAt datetime 티켓 수락 일시
deliveryAmountOriginId int64 배송비 원본 ID
token.lastOrderId int64 다음 조회 시 커서로 사용할 주문 ID
(요청별 주문내역 응답 결과의 마지막 주문ID)
token.lastModifiedAt datetime 다음 조회 시 커서로 사용할 수정 일시
(요청별 주문내역 응답 결과의 마지막 수정 일시)		 
{
  "contents": [
      "orderId": 1234567890,
      "paymentId": 9876543210,
      "orderStatus": "PayComplete",
      "createdAt": "20250601120000",
      "paidAt": "20250601120000",
      "modifiedAt": "20250609153000",
      "deliveryRequestAt": "20250610080000",
      "ticketAcceptedAt": "20250610080000",
      "deliveryAmountOriginId": 123
    }
  ],
  "token": {
    "lastOrderId": 1234567890,
    "lastModifiedAt": "2025-06-09 15:30:00"
  }
}

 

관련 문서