이미지 수정 API

Description

[POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/images

상품 썸네일 및 추가 이미지를 수정하는 API입니다. 추가이미지는 14개까지 등록/수정 가능합니다.

 

Request Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터 상품번호	Y	path	변경하고자 하는 마스터 상품번호 입력
imageModel > BasicImage > URL	상품기본이미지	Y	Stirng	최소 600x600 / 권장 1000x1000 http:// or https:// 형식의 완전한 이미지 URL이어야 하고, 만약 이미지가 없거나 만료된 이미지일 경우 이미지 수정 실패됨
imageModel > AdditionalImage1 > URL	상품추가이미지1		Stirng	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage2 < URL	상품추가이미지2		Stirng	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage3 > URL	상품추가이미지3		Stirng	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage4 > URL	상품추가이미지4		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage5 > URL	상품추가이미지5		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage6 > URL	상품추가이미지6		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage7 > URL	상품추가이미지7		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage8 > URL	상품추가이미지8		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage9 > URL	상품추가이미지9		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage10 > URL	상품추가이미지10		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage11 > URL	상품추가이미지11		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage12 > URL	상품추가이미지12		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage13 > URL	상품추가이미지13		string	최소 600x600 / 권장 1000x1000
imageModel > AdditionalImage14 > URL	상품추가이미지14		string	최소 600x600 / 권장 1000x1000

JSON
{
  "imageModel": {
    "BasicImage": {
      "URL": "string"
    },
    "AdditionalImage1": {
      "URL": "string"
    },
    "AdditionalImage2": {
      "URL": "string"
    },
    "AdditionalImage3": {
      "URL": "string"
    },
    "AdditionalImage4": {
      "URL": "string"
    },
    "AdditionalImage5": {
      "URL": "string"
    },
    "AdditionalImage6": {
      "URL": "string"
    },
    "AdditionalImage7": {
      "URL": "string"
    },
    "AdditionalImage8": {
      "URL": "string"
    },
    "AdditionalImage9": {
      "URL": "string"
    },
    "AdditionalImage10": {
      "URL": "string"
    },
    "AdditionalImage11": {
      "URL": "string"
    },
    "AdditionalImage12": {
      "URL": "string"
    },
    "AdditionalImage13": {
      "URL": "string"
    },
    "AdditionalImage14": {
      "URL": "string"
    }
  }
}

Sample
{
  "imageModel": {
    "BasicImage": {
      "URL": "http://image.auction.co.kr/Itemimage/16/9f/7b/169f7b8fc6.jpg"
    },
    "AdditionalImage1": {
      "URL": "http://image.auction.co.kr/Itemimage/16/9f/7b/169f7b8fc6.jpg"
    },
  }
}

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	성공 시, 적용된 상품번호 Return
resultCode	결과코드	int	0 : 성공 나머지 : 실패
message	메시지	string	성공 or 실패사유
data	데이터	object

JSON_Success

{
  "goodsNo": 0,
  "resultCode": 0,
  "message": null
}

JSON_Fail

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

Sample Code_Success

{
    "goodsNo": 2398849144,
    "resultCode": 0,
    "message": null
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"기본 이미지 URL을 확인 해 주세요."
}

 

 

Error Code

결과코드	메시지	원인
1000	기본 이미지 URL을 확인 해 주세요.	http:// 형식의 정확한 URL이미지 URL 형태가 아닐 경우
1000	추가 이미지는 순차적으로 넣어주세요	추가이미지 순서대로 입력하지 않았을 경우