옵션 이미지의 필드에는 대표 이미지, 추가 이미지가 포함됩니다.
이중 대표 이미지는 필수이며 추가 이미지는 선택사항 입니다.
추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다.
대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다.
주의사항
이미지 URL 은 반드시 이미지업로드 API 로 업로드 후 반환받은 URL 값을 입력하세요.
필드 제약사항
# 이미지들 사이의 동일 이미지 중복 사용 여부
- 대표 이미지 및 추가 이미지들은 서로 간의 동일한 url 형태의 중복 이미지를 허용하지 않습니다.
중복된 이미지가 입력될 경우 에러를 발생합니다.
# 이미지 등록 갯수 제한
- 대표이미지는 1개만 허용하며, 추가 이미지의 경우 최대 3개까지 이미지 등록이 가능합니다.
# 외부 이미지의 경우, UTF-8 방식을 사용해서 인코딩된 URL만 허용합니다.
수정 시 주의사항
# 이미지 정보를 수정하지 않는 경우에는, 조회된 url 정보를 다시 그대로 넣어서 요청해야 합니다.
옵션등록시 샘플
{
"representImage":{
"url":"http://st.kakaocdn.net~~~"
},
"optionalImages":[
{
"url":"http://st.kakaocdn.net~~~"
}
]
}
옵션수정시 이미지 수정이 없는 경우 샘플
옵션 등록후에 옵션을 조회하면 이미지 마다 id가 부여됩니다. 수정하지 않을 경우는 조회된 이미지 정보 그대로 설정합니다.
{
"representImage":{
"url":"hhttp://st.kakaocdn.net/~~~"
},
"optionalImages":[
{
"url":"http://st.kakaocdn.net/~~~"
}
]
}
옵션수정시 이미지를 삭제하는 경우 샘플
삭제하고자는 하는 이미지 정보는 지웁니다. 아래는 optionalImages 정보를 빈배열로 설정하며 삭제하는 경우입니다.
{
"representImage":{
"url":"http://st.kakaocdn.net/~~~~"
},
"optionalImages":[
]
}
옵션수정시 이미지를 추가하는 경우 샘플
업로드 한 이미지 url로 추가합니다. 상품 등록시와 동일합니다.
{
"representImage":{
"url":"http://st.kakaocdn.net/~~~"
},
"optionalImages":[
{
"url":"http://st.kakaocdn.net/~~~~~"
}
]
}
필드 상세
필드명 | 타입 | 필수여부 | 설명 |
---|---|---|---|
representImage | RepresentImage | 필수 | 대표 이미지 정보 |
optionalImages | Array<OptionalImage> | 선택 | 추가 이미지 |