버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

...

번호

구분

설명

1

상품 상세정보 조회

  • 상품상세정보를 조회해서 노출

  • 상품기본정보, 컨텐츠정보, 연관상품, 리뷰간략정보, 상품아이콘정보, 단품기본정보를 조회하여 노출

2

상품별 최대혜택가 조회

  • 상품가격 노출시 최대혜택가 반영하여 노출

  • 최대혜택가정보 API는 프로모션에서 정보를 제공

3

옵션정보 조회 (옵션팝업)

  • 단품의 옵션정보를 SELECT BOX형태로 노출

  • 재고관리여부, 구매수량제한, 최소/최대 구매수량 정보로 수량변경시 validation 체크

4

단품별 재고증차감

  • 주문, 교환, 반품에 의해 재고고 증차가감을 위한 API

  • 주문에서 상품 단품의 주문에 의해 증차감을 요청청

  • 재고관리하는 상품만 증차감 처리

5

증정품 정보보 조회회

-주문에서 해당 상품의 증정품을 보여주기 위해 요청

-증정품 정보는 증정품명만 TEXT로 제공

6

전시상품정보 (전시상품요약)조회

  • 목록에서 사용 할 상품정보를 요약한 정보보이며, 목록에서 상품정보를 노출하기 위해 상품의 정보보를 조회요청

  • 목록에 노출 할 상품들의 조회요청으로 다건의 상품조회기능 제공

  • 상품이미지 상품의 필수값인 대표이미지를 제공

7

상품별 단품정보 조회

  • 상품의 단품들 정보를 조회

  • 상품기본정보, 대표전시카테고리리정보, 단품명, 재고정보, 가격정보를 제공

8

상품별 단품정보 조회(주문전용) 

  • 다건의 상품정보를 조회

  • 주문에서 교환시 구매가능 수량, 판매가격, 단품추가금이 동일한 다른 단품을 선택 할 때 사용

  • 단품재고가 요청수량보다 많은 경우의 단품만 조회

9

대체가능 상품단품정보 조회(장바구니)

  • 다건의 상품정보를 조회

  • 요청받은 상품,단품외의 단품중에 판매가격, 단품추가금이 동일한 다른 단품을 조회

  • 단품추가금이 동일한 다른 단품정보 조회

  • 단품수량이 요청한 수량보다 많은은 단품만 조회

10

상품별 단품정보 조회(장바구니전용)

  • 장바구니에서 단품별 상세정보를 보여주기 위해 요청

  • 다건으로 받은 단품번호 기준으로 단품품정보를 조회

11

상품별 결제가능수단 조회

  • 다건의 상품의 결제수단을 조회

  • 결제수단의 사용여부가 'Y'인 결제수단만 조회

  • 주문에서 상품의 결제수단목록을 보여주기 위해 조회

12

단품별 즉시할인가 조회

  • 즉시할인가정보 API는 프로모션에서 정보 제공

  • 상품목록에서 즉시할인가를 보여주기 위해 요청

API 기능 목록

API

설명

Server

메소드

비고

대체가능 상품단품정보 조회(장바구니)

  • 단건의 상품 조회 시 호출하는 API입니다.

  • 요청 받은 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량 으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 단품목록을 조회합니다.

  • 상품가격은 동일하므로 단품추가금만 확인하여 조회합니다.

  • 단품재고가 요청수량보다 많은 경우만 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

단품별 재고증차감

  • 차감한 단품수량이 재고수량보다 클경우 (마이너스 재고),에러를 리턴합니다.

  • 증가한 단품수량이 안전재고수량보다 클경우 단품판매상태코드 판매 중으로 변경합니다.

Goods

PUT

🔗API 확인하기>

옵션정보 조회 (옵션팝업)

  • 상품에 대한 옵션목록을 조회하기 위한 API 입니다.

  • 묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록을 조회합니다.

  • 상품의 전시여부가 Y이고, 단품의 판매상태가 판매중/품절인 단품이 속한 옵션들을 조회합니다.

  • 단품목록이 없는 단일상품은 조회에서 제외합니다.

  • 리프옵션에 해당하는 단품의 기본정보를 포함합니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

GET

🔗API 확인하기>

상품별 단품정보 조회(장바구니전용)

  • 장바구니에서 단품별 상세정보를 조회하기 위해 호출합니다.

  • 리스트로 받은 단품번호 기준으로 단품의 상세정보를 조회합니다.

  • 쿠키에 저장된 언어코드, 몰번호를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 단품정보 조회(주문전용)

  • 다건의 상품 조회 시 호출합니다.

  • 요청 받은 각 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량 으로 대체가능(판매가격+단품추가금동일한 다른 단품)한 상품별로 단품목록을 조회합니다.

  • 단품재고가 요청수량보다 많은 경우만 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 단품정보 조회

  • 상품번호에 따라 상품 내 모든 단품의 정보를 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

  • 단품명, 재고정보, 가격정보를 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 최대혜택가 조회 (프로모션 제공)

  • 상품의 최대혜택가를 조회하는 API 입니다.

  • request에 단품번호가 없는 경우는 상품의 단품번호가 가장 빠른 단품을 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.

  • request에 단품번호가 있는 경우는 상품의 해당 단품번호를 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.

  • 최대혜택가에 해당하는 프로모션리스트를 조회합니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • request에 채널번호가 있는 경우 해당 채널번호를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 채널번호를 사용하여 조회합니다.

  • 로그인을 한 경우 로그인 사용자 정보가 프로모션 최대혜택가 계산 조건에 적용됩니다.

Goods

GET

🔗API 확인하기>
[상품상세 최대혜택가조회]
/api/order/v1/marketing/maxDcAmt

단품별 즉시할인가 조회

  • 단품별 즉시할인가를 조회하는 API 입니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • 단품에 즉시할인가가 적용된 가격정보를 조회합니다.

Goods

GET

🔗API 확인하기>
[상품별 즉시할인가 조회]
/api/order/v1/marketing/goodsDirectDiscountList

상품별 결제가능수단 조회

  • 다건의 상품별 각각의 결제수단을 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

  • 결제수단의 사용여부가 'Y'인 결제수단만 조회합니다

Goods

POST

🔗API 확인하기>

증정품 정보 조회

  • 상품에 해당하는 증정품을 조회합니다.

  • 1001: request값이 없거나, request값에 상품번호가 없는 경우 발생하는 오류입니다.

Goods

POST

🔗API 확인하기>

상품 상세정보 조회

  • 상품의 상세페이지에서 상품정보를 상세 조회하기 위한 API 입니다.

  • 전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회합니다.

  • 상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계정보를 조회합니다.

  • 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.

Goods

GET

🔗API 확인하기>

전시상품정보(전시상품요약)조회

  • 다건의 상품조회가 가능합니다.

  • 이미지는 상품의 대표이미지를 제공합니다.

  • 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다

Goods

POST

🔗API 확인하기>

...