선물하기 상품 이미지 등록 시, 카카오 이미지 서버에 이미지 업로드 후 카카오에서 응답된 이미지 url을
입력하셔야 합니다. 상품에 필요한 이미지를 업로드 해주세요.
참고사항
이미지 파일의 형식은 jpg, jpeg, png만 지원하며 10MB를 초과할 수 없습니다.
대표이미지, 추가이미지는 사이즈는 최소 550x550 이상으로 등록해주세요. (권장 750x750)
상품 상세설명에 포함될 이미지를 등록할 경우에는 TYPE: EDITOR 로 등록해주세요. EDITOR로 등록 시 별도 사이즈 제한은 없습니다. (파일 크기 10MB 이내)
1회 이미지 업로드 시 최대 10개까지 가능합니다.
요청
POST /v1/gift/image/upload
<요청 파라미터 설명>
필드명 | 타입 | 필수여부 | 설명 |
uploadUrls | Array | 필수 | 이미지 URL |
type | String | 선택 |
이미지 등록 타입 PRODUCT: 대표이미지, 추가이미지 EDITOR: 상품 상세설명 이미지 |
응답
성공시에는 카카오 이미지 url 이 응답바디에 포함됩니다.
<응답 바디>
필드명 | 타입 | 설명 |
uploadResult | List<FileUploadResponse> |
이미지 목록 결과 |
<응답 바디 샘플>
- 성공
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"uploadResult": [
{
"result": "SUCCESS",
"data": {
"originUrl": "https://st.kakaocdn.net/product/gift/image.png",
"width": 1024,
"height": 1363,
"fileSize": 179364,
"animated": false
}
},
{
"result": "SUCCESS",
"data": {
"originUrl": "https://st.kakaocdn.net/product/gift/editor/image.png",
"width": 1700,
"height": 1133,
"fileSize": 686879,
"animated": false
}
}
]
}
- 일부 실패
HTTP/1.1 400 OK
Content-Type: application/json;charset=UTF-8
{
"uploadResult": [
{
"result": "SUCCESS",
"data": {
"originUrl": "https://st.kakaocdn.net/product/gift/image.png",
"width": 1024,
"height": 1363,
"fileSize": 179364,
"animated": false
}
},
{
"result": "FAILURE",
"data": {
"message": {
"unknown": [
"TENTH_RESOURCE_NOT_FOUND:tenth responseCode : 404, source : http://orgin.com/image.png, uploadUrl : /gift/product/image.png"
]
}
}
}
]
}
FileUploadResponse
이미지 업로드 상세 필드
필드명 | 설명 |
result |
성공여부 SUCCESS: 성공 FAILURE: 실패 |
data |
이미지 업로드 결과 originUrl: 카카오 이미지 url width: 너비 height: 높이 fileSize: 파일 사이즈 animated |