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