상품 이미지 비동기 업로드 요청, 옵션 이미지 비동기 업로드 요청의 업로드 완료를 확인합니다.
업로드 요청 API 에서의 결과 url 을 해당 API 의 패러미터로 사용하여 업로드 요청한 이미지의 업로드 완료를 확인합니다.
주의사항
업로드 요청 이미지의 확인 가능 시간은 10분 이내 입니다. 업로드 요청을 하고 10분 이내에 확인 요청을 할 때만 유효한 값을 얻을 수 있습니다.
비동기 요청으로 이루어지므로 업로드 요청 후 즉시 확인 요청을 할 경우 아직 업로드 중인 상태인 경우가 있어 확인 요청은 재시도가 필요합니다.
외부 이미지의 경우, UTF-8 방식을 사용해서 인코딩된 URL만 허용합니다.
요청
GET /v1/store/product/image/check/url
<요청 패러미터>
키 | 타입 | 필수여부 | 설명 |
---|---|---|---|
url | String | 필수 | 이미지 비동기 업로드 요청 API 의 응답 body url |
응답
성공시에는 카카오 이미지 url 이 응답바디에 포함됩니다.
- 상품 등록시 : ProductImage 내에 url 필드로 설정하고,
요청했던 ratio 값을 ProductImage 내 imageRatio 필드에 동일값으로 설정해야 합니다. - 옵션 등록시 : OptionImage 내에 url 필드로 설정해야 합니다.
<응답 바디>
필드명 | 타입 | 필수여부 | 설명 |
---|---|---|---|
code | String | 필수 | 응답의 결과 code (“ACCEPTED”, “SUCCESS”) |
url | String | 필수 | 저장될 이미지 URL |
<응답 바디 샘플>
업로드 완료
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"code": "SUCCESS",
"url": "https:xxx"
}
업로드 진행중
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"code": "ACCEPTED",
"url": "https:xxx"
}
요청 데이터를 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
{
"msg": "KakaoStoreException",
"code": -800,
"extras": {
"error_code": -18902,
"error_message": "요청 데이터가 존재하지 않습니다."
}
}