메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

이 페이지의 이전 버전을 보고 있습니다. 현재 버전 보기.

현재와 비교 페이지 이력 보기

버전 1 다음 »

이커머스 웹사이트 또는 애플리케이션에서 개별 상품에 대한 상세 정보를 제공하고 관리하는 데 사용되는 인터페이스입니다.

사용자에게 특정 상품에 대한 다양한 정보를 효과적으로 전달하고 구매 프로세스를 원활하게 진행할 수 있습니다.


(더하기) 상품 상세보기

1. 상품 정보 조회

해당 상품의 기본정보 및 상세 정보를 조회할 수 있습니다.

상품상세정보 조회

GET /v1/detail/goodsDetail 🔗API 확인하기 >

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

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

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

2. 쿠폰 조회

로그인 사용자가 [쿠폰보기] 클릭 시 나타나는 쿠폰 팝업이 나타납니다.

발급 가능쿠폰과 보유한 쿠폰 정보를 조회 할 수 있고, 발급이 가능한 쿠폰을 다운로드 할 수 있습니다.

2.1 쿠폰 목록 조회

상품상세 다운로드 가능 쿠폰조회

POST /v1/marketing/goodsDetailCpnList 🔗 API 확인하기 >

  • 발급 가능쿠폰 : 로그인한 사용자가 발급 가능한 쿠폰 목록를 조회함

  • 보유한 쿠폰 : 로그인한 사용자가 보유한 쿠폰 목록를 조회함

2.2 쿠폰 다운로드

쿠폰다운로드(FO)

POST /v1/marketing/cpnDown 🔗 API 확인하기 >

  • 쿠폰 전체받기 : 발급 가능한 쿠폰 전체 다운로드

  • 다운로드 : 클릭 된 쿠폰 다운로드

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. 상품평 보기

리뷰번호별 상품평 목록 조회(전시제공)

GET /v1/review/seltRevList/{goodsNo} 🔗API 확인하기 >

상품별로 작성된 상품 리뷰의 정보를 조회함

4. 상품평 도움 돼요

상품리뷰 도움돼요 등록

GET /v1/review/{goodsNo}/hlpful/{revNo} 🔗API 확인하기 >

상품 리뷰에 등록된 도움 돼요 기능을 등록하고 등록된 총 개수를 조회함


(더하기) 상품 Q&A

상품 상세 페이지에서 [상품 Q&A]를 클릭하면 해당 상품에 대한 상품 Q&A 팝업이 나타납니다.

로그인한 고객만 상품 Q&A 작성/수정/삭제를 진행할 수 있습니다.

1. 상품 Q&A 목록

상품별 Q&A정보 조회

GET /v1/qna/{goodsNo} 🔗API 확인하기 >

상품별 Q&A 정보를 조회합니다.

2. 상품 Q&A 등록

로그인한 고객이 [상품 Q&A 작성] 버튼을 클릭하면 해당 상품에 대한 상품 Q&A 작성 팝업이 나타납니다.

상품 Q&A 등록

POST /v1/qna/insertQna/{goodsNo} 🔗API 확인하기 >

상품QnA 등록합니다.

3. 상품 Q&A 수정

로그인한 고객이 작성한 상품 Q&A 수정을 진행할 수 있습니다.

하지만 답변완료 처리된 Q&A와 다른 고객이 작성한 Q&A는 수정/삭제 할 수 없습니다.

[수정] 버튼을 클릭하면 작성된 상품 Q&A작성 팝업이 나타납니다.

3.1 상품 Q&A 상세 조회하기

상품 Q&A 상세내용 조회

GET /v1/qna/seltQnaDetail/{pdQnaNo} 🔗API 확인하기 >

상품 Q&A 상세내용 조회한다.

3.2 상품 Q&A 수정하기

내용을 수정하고 [수정] 버튼을 클릭하면 수정된 내용으로 등록할 수 있습니다.

상품 Q&A 수정

POST /v1/qna/modifyQna/{pdQnaNo} 🔗API 확인하기 >

상품 Q&A를 수정한다.

4. 상품 Q&A 삭제

로그인한 고객이 작성한 [삭제]를 클릭해 문의 글을 삭제할 수 있습니다.

상품 Q&A 삭제 

DEL /v1/qna/deleteQna/{pdQnaNo}  🔗API 확인하기 >

상품 Q&A 삭제한다.


(더하기) 묶음상품 조회하기

X2BEE BO에서 묶음 상품으로 등록된 상품을 전시할 수 있습니다.

1. 묶음 상품 요약 정보

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

POST /v1/detail/summary 🔗 API 확인하기 >

상품의 요약된 정보 조회 API로 이미지는 상품의 대표이미지를 제공합니다.

2. 상품 상세 조회하기

묶음 상품의 상세정보에서 [상세보기] 버튼을 클릭하면, 해당 상품의 상품 상세내용을 조회합니다.

상품 상세 정보를 조회하는 API는 상품 상세 문서의 1. 상품 정보 조회하기를 참고해 주세요.

  • 레이블 없음