상품 조회

전체 상품정보를 필요로 할 때 사용합니다. 상품번호 또는 판매자 상품코드로 조회 할 수 있습니다.

판매자 상품코드로 조회시에는 상품정보가 배열 형태로 반환됩니다.

(판매자 상품코드에 대해 유일성 체크를 하지 않으므로 배열 형식을 사용합니다.)

상품 조회에 반환되는 타입은 productId와 productSaleStatus가 추가로 들어가며 그 외는 ProductRequest 와 동일합니다.

일정형(SCHEDULE) 옵션 상품과 숙소상품 카테고리 상품은 다음이 다릅니다.

• 일정형 상품의 option 에는 일정(schedule)이 포함되지 않습니다. 일정 설정과 일정가격은 옵션 조회 응답의 schedule 로 확인해 주세요.
• 일정형 상품의 stockQuantity 는 판매 가능한 일정 재고의 합계입니다(사용여부가 true 이고 날짜가 오늘을 포함한 이후인 일정). 0 이면 판매할 수 있는 옵션이 없다는 뜻이며, 합계가 0 보다 커도 특정 날짜는 품절일 수 있습니다. 상품 수정 요청에 넣어도 일정형 상품의 이 값은 무시됩니다.
• 상품번호로 조회하면, 숙소상품 카테고리 상품에 숙소정보가 등록돼 있을 때 accommodation 이 함께 반환됩니다. 판매자 상품코드로 조회한 응답에는 accommodation 이 포함되지 않습니다.

상품 번호로 요청

GET /v1/store/product?productId={productId} HTTP/1.1

<요청 패러미터>

상품 번호 요청시 응답

조회 성공시에는 응답 바디에 상품정보가 포함되나, 상품번호에 매칭되는 상품이 없는 경우 404 에러 응답이 반환됩니다.

<응답 바디>

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
   "productId" : 1,
   "그 외 정보" : "상품등록 request 예제를 참고하시기 바랍니다."
}

판매자 상품코드로 요청

판매자 상품코드에 대해서는 상품등록시에 유일성 체크를 하지 않으므로, 매칭 되는 상품이 없는 경우 빈 배열이 반환되고, 조회되는 경우에는 상품수 만큼의 배열로 반환됩니다.

GET /v1/store/product/store_managed_code?code={code} HTTP/1.1

<요청 패러미터>

판매자 상품코드로 요청시 응답

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
 {
    "productId" : 1,
    "그 외 정보" : "상품등록 request 예제를 참고하시기 바랍니다."
 }
]