덤 API

Description

등록 : [POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus 수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus 삭제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus

고객이 상품 구매 시 제공받을 수 있는 덤 정보 등록/수정/삭제/조회 기능을 제공합니다.

Request Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터상품번호	Y	path
base	덤 기준 주문수량		int	1~99까지 입력 가능
bonus	덤 제공 수량		int	1~99까지 입력 가능
manageCode	덤 관리 코드		string	영문/숫자만 입력 가능

JSON
등록/수정
{
  "base": int,
  "bonus": int,
  "manageCode": "string"
}

해제/조회 - URL만 호출 / Request Body 없음
해제 [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus
조회 [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	조회시 내려가는 정보
resultCode	결과코드	int	실패 시 내려가는 정보
message	메시지	string	실패 시 내려가는 정보

 JSON_Success

등록/수정/해제
{
  "goodsNo": 0
}

조회
{
  "base": int,
  "bonus": int,
  "manageCode": "string"
}

JSON_Fail

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

Sample Code_Success

{
  "goodsNo": 1158387297
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"오류메시지"
}

Error Code

결과코드	메시지	원인
1000	덤 기준은 1~99까지 입력 가능합니다.	기준 수량 항목,값 누락 또는 초과값,문자,특수문자 입력할 경우
1000	덤 제공 개수는 1~99까지 입력 가능합니다.	제공 수량 항목,값 누락 또는 초과값,문자,특수문자 입력할 경우
1000	사은품/덤 관리코드 항목은 영/숫자만 등록 가능합니다.(공백불가)	관리코드 항목내 특수문자,한글,기호 등 입력한 경우
1000	[G마켓] 토큰을 확인 해 주세요. 또는 [옥션] 토큰을 확인 해 주세요.	호출 시 한 사이트의 토큰으로 호출했을 경우
1000	상품 번호가 잘 못 되었습니다.(GoodsMaster)	마스터 상품코드 아닌 사이트 상품코드 적용,호출 한 경우
1000	해당 판매자의 상품이 아닙니다.	조회하려는 상품번호와 토큰 매칭이 되지 않을 경우
1000	"[G마켓] 상품번호가 생성 되지 않았습니다. 또는 [옥션] 상품번호가 생성 되지 않았습니다."	개별사이트 상품번호만 채번되어있는 상품의 경우 두 사이트 토큰 사용 한 경우
3000	404 Not Found	상품코드 자릿수 미만 적용한 경우