톡스토어 상품 이미지 등록 시, 카카오 이미지 서버에 이미지 업로드 후 카카오에서 응답된 이미지 url을 입력하셔야 합니다.
이를 위해 상품에 필요한 이미지를 비동기로 업로드 해주세요.
주의사항
이미지 파일의 형식은 jpg, jpeg, png만 지원하며 10MB를 초과할 수 없습니다.
이미지 비율은 1:1 또는 3:4 중 선택 입력해 주세요.
이미지 사이즈는 이미지 비율 1:1 기준으로 750X750 이상을 권장하며, 최소 375X375 이상이어야 합니다.
3:4 비율인 경우에는 750X1000 이상을 권장하며, 최소 375X500 이상이어야 합니다.
외부 이미지의 경우, UTF-8 방식을 사용해서 인코딩된 UR만 허용합니다.
요청
POST /v1/store/product/image/upload/url
<Content-type: application/x-www-form-urlencoded 요청>
POST /v1/store/product/image/upload/url?url={}&ratio={} HTTP/1.1
Content-type: application/x-www-form-urlencoded;charset=utf-8
| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| url | String | 필수 | 이미지를 다운받을수 있는 유효한 URL |
| ratio | ImageRatio | 필수 | 이미지 비율 |
<Content-type: application/json 요청 >
POST /v1/store/product/image/upload/url HTTP/1.1
Content-type: application/json
$RequestBody
| RequestBody |
|---|
| “url”, “ratio” 를 키로 가지는 json object. 값 타입은 urlencoded 파라미터 설명참조 |
응답
성공시에는 카카오 이미지 url 이 응답바디에 포함됩니다.
이 url을 이미지 업로드 확인 API 의 패러미터로 지정합니다.
<응답 바디>
| 필드명 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| url | String | 필수 | 저장될 이미지 URL |
<응답 바디 샘플>
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"url": "http://~~"
}