그룹생성/수정/삭제 API

Description

그룹생성 : [POST] https://sa2.esmplus.com/item/v1/groups 그룹수정 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo} 그룹상품 개별등록 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo}/goods/{goodsNo} 그룹상품 복수등록 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo}/goods 그룹삭제 : [DELETE] https://sa2.esmplus.com/item/v1/groups/{groupNo}

2.0 상품의 경우 연관된 상품을 묶어 상품상세페이지에서 함께 노출하여 구매를 향상시킬 수 있습니다. 딜구조와는 다른 개념으로 대표상품에 종속되는 개념이 아니므로 그룹에 묶인 모든 상품은 동일하게 검색에 노출됩니다. 기본적으로 대표상품으로 등록하는 상품의 기준과 유사한 상품만 묶을 수 있습니다. 그룹 상품 개별 등록시 해당 그룹 기존 상품은 유지되며 1개씩 상품을 추가할 수 있습니다. 그룹 상품 복수 등록시 해당 그룹 기존 상품은 모두 삭제되며(대표상품 제외) 요청한 상품으로 재설정 됩니다. G마켓 상품별, 옥션 상품별로 그룹핑 할 수 있습니다. (G마켓 상품과 옥션 상품을 한 그룹 안에 묶을 수 없음) 동일 판매자 ID 내의 상품끼리만 가능합니다. (사이트별 판매자 ID가 2개 이상일 경우에 한 함) 한 그룹당 최대 50개의 상품까지 등록할 수 있으며, 그룹 자체의 개수는 제한 없습니다. 1개 상품을 2개의 그룹에 중복 설정 할 수 없습니다.

 

Request Description

항목	항목명	필수여부	Type	Description
groupNo	그룹번호	Y	Path	수정/삭제시 그룹번호 입력
groupName	그룹명	Y	String	50byte까지 입력 가능
groupListType	그룹리스트타입		String	0: 리스트형 1: 이미지형
introImageFile	인트로이미지		String	- 사이즈 860*600 로 등록 가능 - jpg, png 파일만 등록 가능
goodsNo	마스터상품번호	Y	int	- 생성시 그룹 기준 상품번호 등록 - 수정시 파라미터 호출하지 않음

JSON
그룹생성
{
  "goodsNo": 0,
  "groupName": "string",
  "groupListType": "0",
  "introImageFile": "string"
}

수정
{
  "groupName": "string",
  "groupListType": "0",
  "introImageFile": "string"
}

개별 상품 등록/삭제 - URL만 호출 / Request Body 없음
개별등록 [PUT] https://sa2.esmplus.com/item/v1/groups/694498/goods/1156674114
그룹삭제 [DELETE] https://sa2.esmplus.com/item/v1/groups/784220

복수 상품 등록
{
  "goodsNo": [
    0
  ]
}

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	성공 시, 적용된 상품번호 Return
resultCode	결과코드	int	0: 성공 나머지 : 실패
message	메시지	string	성공 or 실패사유
data	데이터	object
groupNo	그룹번호	Path	조회한 그룹번호 내려감
groupName	그룹명	String
groupListType	그룹리스트타입	String	"0: 리스트형 1: 이미지형"
introImageFile	인트로이미지	String
giCategoryCode	그룹카테고리코드	int	그룹대표 카테고리코드(대중소전체 내려감)
deliveryTmplId	대표배송정책번호	int	배송비정책번호
goodsNo	마스터상품번호	int	등록된 모든 상품번호 배열로 내려감

 JSON_Success

생성/수정/삭제
{
  "groupNo": 0
}

상품등록
{
  "goodsNo": 0
}

JSON_Fail

{
   "resultCode": 0,
   "message": "string"
}

Sample Code_Success

생성/수정/삭제
{
  "groupNo": 694498
}

상품등록
{
  "goodsNo": 1156674114
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"유효하지 않은 그룹 입니다.(해당 그룹 정보가 없습니다.)"
}

 

Error Code

결과코드	메시지	원인
1000	유효하지 않은 그룹 입니다.(해당 그룹 정보가 없습니다.)	조회하려는 그룹번호가 존재하지 않을 경우