버전 비교

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

...

번호

구분

설명

1

상품 상세정보 조회

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

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

2

상품별 최대혜택가 조회

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

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

3

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

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

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

API 기능 목록

API

설명

Server

매소드메소드

비고

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

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

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

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

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

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

Goods

POST

단품별 재고증차감

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

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

Goods

PUT

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

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

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

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

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

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

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

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

Goods

GET

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

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

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

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

Goods

POST

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

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

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

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

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

Goods

POST

상품별 단품정보 조회

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

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

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

Goods

POST

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

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

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

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

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

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

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

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

Goods

GET

[상품상세 최대혜택가조회]
/api/order/v1/marketing/maxDcAmt

단품별 즉시할인가 조회

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

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

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

Goods

GET

[상품별 즉시할인가 조회]
/api/order/v1/marketing/goodsDirectDiscountList

상품별 결제가능수단 조회

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

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

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

Goods

POST

증정품 정보 조회

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

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

Goods

POST

상품 상세정보 조회

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

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

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

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

Goods

GET

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

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

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

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

Goods

POST

...