이커머스 웹사이트 또는 애플리케이션에서 개별 상품에 대한 상세 정보를 제공하고 관리하는 데 사용되는 인터페이스입니다.
사용자에게 특정 상품에 대한 다양한 정보를 효과적으로 전달하고 구매 프로세스를 원활하게 진행할 수 있습니다.
상품 상세보기
1. 상품 정보 조회
해당 상품의 기본정보 및 상세 정보를 조회할 수 있습니다.
상품상세정보 조회
GET /v1/detail/goodsDetail 🔗API 확인하기 >
상품상세페이지에서 상품정보를 상세 조회하기 위한 API입니다.
전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회함
상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계 정보가 조회됨
2. 쿠폰 조회
로그인 사용자가 [쿠폰보기] 클릭 시 나타나는 쿠폰 팝업이 나타납니다.
발급 가능쿠폰과 보유한 쿠폰 정보를 조회 할 수 있고, 발급이 가능한 쿠폰을 다운로드 할 수 있습니다.
2.1 쿠폰 목록 조회
상품상세 다운로드 가능 쿠폰조회
POST /v1/marketing/goodsDetailCpnList 🔗 API 확인하기 >
발급 가능쿠폰 : 로그인한 사용자가 발급 가능한 쿠폰 목록를 조회함
보유한 쿠폰 : 로그인한 사용자가 보유한 쿠폰 목록를 조회함
2.2 쿠폰 다운로드
3. 카드사 혜택
상품 기본 정보에서 [카드사 혜택]을 클릭하면 카드 행사 혜택 안내 팝업이 나타납니다.
3.1 카드사 혜택 조회 팝업
무이자할부 안내 목록 조회
GET /v1/payment/getInterestFreeList 🔗API 확인하기 >
BO의 무이자할부 안내 관리에서 등록한 무이자할부 안내 목록을 조회합니다.
4. 사은품 조회
고객이 상품 구매 시 증정되는 사은품은 로그인한 고객에게만 나타납니다.
상품상세 사은행사 조회
POST /v1/marketing/aeEvtList 🔗 API 확인하기 >
상품 상세에서 사은행사 리스트를 조회하는 API 입니다.
사은행사 번호 당 사은행사혜택순번이 가장 높은 사은품 하나만 반환합니다.
상품 상세 페이지내 상품정보고시와 배송/교환/반품에 대한 정보를 제공할 수 있습니다.
5. 상품정보고시 팝업
[상품정보고시]를 클릭하면 해당 상품에 대한 상품정보고시 팝업이 나타납니다.
상품정보고시에 대한 API는 상품상세 문서에서 1.상품 정보 조회하기의 내용을 참고해주세요.
6. 배송/교환/반품 정보 팝업
[배송/교환/반품]을 클릭하면 해당 상품에 대한 배송/교환/반품 정보를 조회할 수 있습니다.
상품별 배송교환반품 정보 조회
GET /v1/delivery/pd/{goodsNo} 🔗API 확인하기 >
상품번호 값으로 사용이 매칭 된 배송정책 및 협력사 배송지 정보 리스트를 조회합니다.
장바구니 담기/바로구매 버튼
1. 장바구니/바로 구매하기
상품 기본정보 스크롤 다운 후 나타나는 장바구니/바로구매 버튼을 클릭하면 상품 옵션 선택 팝업이 나타납니다.
1.1 상품 옵션정보 조회
상품 등록시 설정한 상품에 대한 단품 옵션 정보를 조회합니다.
옵션정보 조회
GET /v1/detail/goodsOptionInfo 🔗API 확인하기 >
상품의 옵션 정보와 각 단품에 대한 금액, 재고 정보를 조회합니다.
묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록이 조회됩니다.
1.2 장바구니 담기 / 바로구매 하기
해당 상품의 옵션을 선택하고 장바구니에 담거나 바로구매를 진행할 수 있습니다.
장바구니 등록
POST /v1/basket/registerBasket 🔗 API 확인하기 >
상품을 장바구니에 등록합니다.
비회원이고 최초 등록이라면 세션번호가 생성되어 쿠키에 저장됩니다.
상품평
상품 상세 페이지에서 보이는 상품평 영역과 상품평 페이지는 동일한 API로 구현할 수 있습니다.
상품평 페이지는 등록된 상품평과 [상품평 보기>]나 상품평을 클릭해 이동할 수 있습니다.
1. 등록된 상품평 정보 조회
해당 상품에 등록된 전체 리뷰들의 정보를 확인할 수 있습니다.
상품별 상품평 요약정보 조회
GET /v1/review/seltRevTotalInfo/{goodsNo} 🔗API 확인하기 >
상품리뷰 총 갯수, 평점, 평가통계, 평가통계등 상세한 리뷰의 정보를 조회함
2. 상품평 사진/동영상 썸네일 조회하기
해당 상품에 등록된 리뷰의 이미지/동영상 썸네일을 조회합니다.
최근 등록 상품평 컨텐츠 조회
GET /v1/review/getRevContListOfRepresent/{goodsNo}
🔗API 확인하기 >
작성된 상품리뷰의 사진과 동영상의 썸네일을 조회합니다.
3. 상품평 보기
4. 상품평 도움 돼요
상품리뷰 도움돼요 등록
GET /v1/review/{goodsNo}/hlpful/{revNo} 🔗API 확인하기 >
상품 리뷰에 등록된 도움 돼요 기능을 등록하고 등록된 총 개수를 조회함
상품 Q&A
상품 상세 페이지에서 [상품 Q&A]를 클릭하면 해당 상품에 대한 상품 Q&A 팝업이 나타납니다.
로그인한 고객만 상품 Q&A 작성/수정/삭제를 진행할 수 있습니다.
1. 상품 Q&A 목록
2. 상품 Q&A 등록
로그인한 고객이 [상품 Q&A 작성] 버튼을 클릭하면 해당 상품에 대한 상품 Q&A 작성 팝업이 나타납니다.
묶음상품 조회하기
X2BEE BO에서 묶음 상품으로 등록된 상품을 전시할 수 있습니다.
1. 묶음 상품 요약 정보
2. 상품 상세 조회하기
묶음 상품의 상세정보에서 [상세보기] 버튼을 클릭하면, 해당 상품의 상품 상세내용을 조회합니다.
상품 상세 정보를 조회하는 API는 상품 상세 문서의 1. 상품 정보 조회하기를 참고해 주세요.