ProductImage

상품 이미지의 필드에는 대표 이미지, 추가 이미지, 기본 이미지 비율 코드가 포함됩니다.

이중 대표 이미지, 기본이미지 비율 코드는 필수이며 추가 이미지는 선택사항 입니다.

추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다.

대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다.

주의사항

이미지 URL 은 반드시 이미지업로드 API 로 업로드 후 반환받은 URL 값을 입력하세요.

필드 제약사항

# 이미지들 사이의 동일 이미지 중복 사용 여부
  - 대표 이미지 및 추가 이미지들은 서로 간의 동일한 url 형태의 중복 이미지를 허용하지 않습니다. 
  중복된 이미지가 입력될 경우 에러를 발생합니다.
# 이미지 등록 갯수 제한
  - 대표이미지는 1개만 허용하며, 추가 이미지의 경우 최대 5개까지 이미지 등록이 가능합니다.
# 외부 이미지의 경우, UTF-8 방식을 사용해서 인코딩된 URL만 허용합니다. 

수정 시 주의사항

# 이미지 정보를 수정하지 않는 경우에는, 조회된 url 정보를 다시 그대로 넣어서 요청해야 합니다.

상품등록시 샘플

{
  "imageRatio":"SQUARE",
  "representImage":{
    "url":"http://st.kakaocdn.net~~~"
  },
  "optionalImages":[
    {
      "url":"http://st.kakaocdn.net~~~"
    }
  ]
}

상품수정시 이미지 수정이 없는 경우 샘플

상품 등록후에 상품을 조회하면 이미지 마다 id가 부여됩니다. 수정하지 않을 경우는 조회된 이미지 정보 그대로 설정합니다.

{
  "imageRatio":"SQUARE",
  "representImage":{
    "url":"hhttp://st.kakaocdn.net/~~~"
  },
  "optionalImages":[
    {
      "url":"http://st.kakaocdn.net/~~~"
    }
  ]
}

상품수정시 이미지를 삭제하는 경우 샘플

삭제하고자는 하는 이미지 정보는 지웁니다. 아래는 optionalImages 정보를 빈배열로 설정하며 삭제하는 경우입니다.

{
  "imageRatio":"SQUARE",
  "representImage":{
    "url":"http://st.kakaocdn.net/~~~~"
  },
  "optionalImages":[
  ]
}

상품수정시 이미지를 추가하는 경우 샘플

업로드 한 이미지 url로 추가합니다. 상품 등록시와 동일합니다.

{
  "imageRatio":"SQUARE",
  "representImage":{
    "url":"http://st.kakaocdn.net/~~~"
  },
  "optionalImages":[
    {
      "url":"http://st.kakaocdn.net/~~~~~"
    }
  ]
}

필드 상세