API 문의 사항은 tech-support@rapportlabs.kr 으로 부탁드립니다.
상품 썸네일 노출 방식으로는 직접 썸네일 URL 을 업로드하는 방식과 이미지 파일을 직접 업로드하는 방식을 지원하고 있습니다. 여기서는 직접 이미지 업로드하는 방식을 설명합니다.
이미지 업로드를 위해서 2 단계의 과정으로 진행하는데요.
먼저, 이미지 파일 객체를 업로드할 수 있는 URL을 호출하여 응답을 받습니다.
•
generateImageUploadableUrl
◦
POST /seller/images/{imageCategory}/uploadable-url
◦
상품 썸네일 기준으로 imageCategory에는 PRODUCT_MAIN 을 넣어주시면 됩니다.
◦
filename 에는 업로드하는 파일명을 넣으면 됩니다. (샘플 : 1000_main.jpg )
•
여기의 응답 값의 url 필드가 이미지 컨텐츠를 업로드하실 수 있는 정보이며 해당 API에 PUT , Content-Type은 image/jpeg 를 넣고 실제 binary 정보는 요청 body에 넣어서 호출합니다.
•
추가적인 응답 필드를 설명 드리면 uploadedUrl 은 실제 상품 이미지에 접근할 URL 정보이며, 이 값을 상품 등록/수정시에 넣으시면 됩니다. expiredAtMillis 는 이미지 업로드할 경로의 만료시각입니다. (기본 60초 후에 만료합니다.) UploadableUrl API를 응답한 다음에 바로 업로드 를 수행하시는 것이 맞습니다.
아래는 위 내용을 조금 더 상세하게 요청과 함께 설명 안내드립니다.
1.
generateImageUploadableUrl 을 요청하게 되면 url 와 uploadedUrl 응답이 내려옵니다.
•
url 이 이미지 컨텐츠를 업로드하는 URL이며 일정시간 후(1분 후 만료)에는 만료시간이 존재합니다.
•
상품 등록시 imageUrl 필드에는 uploadedUrl 을 넣어주시면 됩니다.
•
요청 예시
curl 'https://seller.api.dev.queenit.kr/seller/images/PRODUCT_MAIN/uploadable-url?filename=1_main.jpg' \
-X 'POST' \
-H 'Authorization: bearer [셀러_토큰]'
Shell
복사
{
"url": "https://damoa-image-dev.s3.ap-northeast-2.amazonaws.com/product/asset/v1/upload/da8db4945e19456aa3c4ced7fa5e12e5.png?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLW5vcnRoZWFzdC0yIkYwRAIgST3F7VJAiJxrWSf0jfr%2B3jxNkjGybGgPmLHRmwgYmBQCIALXINvdLCU7pKy6ZKgRyzkUCz80L0GCDD3ZA6W%2BIsuOKooFCIL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQBBoMMjc5MTgyNDUwMTUxIgxPMbrm3KpRgzzpHwAq3gTyPvI9SpU0bTtjVJYjHZyPziXfgSqJb360qT36WOXikwSHmPFb6NK2%2FtoNPOdHY2M5swlN%2FCOyJLhRwBW2FCDDdlq5QZPaXIOeZCeU%2B7Mx9GFNqCPD2UgCtsgPFJTWs4SsW26g2UJlFra6kN5gW%2Fgz6qls%2BYZlFcm6kcmuLUMZz9Y%2BEgleQjAo7YbXa7C58R2ngkIkXle6CwEqdcfc0ThGgeDVm0dkMRs6VhQlqcwrT4VcV4Jex0VH0caI8Q3V3kKUdaQSi7klf%2B%2FlO6xWF%2B10rnhRhu7Ee2sOjn2BlR%2FgSFYhkMCTRk7glKXaGlAgKoUYo13g0kNgQN4%2FxQbH9Zv1awDrbus5t%2Bqin0PcaJrQzj96FNKVpOYL62aLGdKoeZ6yaK8xk0GN%2FoOZWm3DJrV%2BVfGZVeYFH7GVseMw4cdLXgH5R%2FNwW76PoOqSjJb87Wz2SU5QwjqD6Trc6s3uQUiW2f97HhH4SuqFWJBc8hmbpnSHYk44BvaCOa83SwlS3rnryh9Qehj8piucEKfLroBVmh%2BGOaM%2FCzjkXpfyqc6n8XvMR7WPQFSNfZE2KhCIMFlCUIv8gN0tuZcaw76Ure83eVF0TGzge6Y6BPnNx%2BmG%2B4ufvPptiQ1mUJDBTFun95c5LPMXVIdaGQVuV1lyfuGy%2B4E7Ch0G0MywVrsad8hHK3hXKPi7nzJoU%2BDY2tCIDnQ5X85u9rmDbtcin8eIRI5hv7i%2FFyRWsPDanjOoZ2JPU3eMbOaM5xRmqRLKz0ey9buQNtbcAD1QNJ3ImzaGiyQrBGsO4%2BNzt45sVbmFhVAw6cbltQY6mwGLfuxuZeuN6TfkoXYumOLFZlkbE8xpRlr0DKYkQMTy6L7ttgnj%2F4%2BugoDhMRGzhGJ49r8wdoCP9VsyRRbLtmvq0gJ7XvdR0TUxekQriC6IphIMvAueSr0XhJYEu3B1ByzMQgCrf%2BQ1IarfaA55Ta3Yk16BJczJVdM2NRJSWHdZlUq313z76Ahhs5PJqv3w2WSdIjscn3BXWak7vA%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240812T012041Z&X-Amz-SignedHeaders=host&X-Amz-Expires=60&X-Amz-Credential=ASIAUCAESDXTQ365AQPO%2F20240812%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Signature=e4d6fdd7a63f338739ebbb26ba1b15644bfd3c1a4b53acf9d5a222d8515047c4",
"uploadedUrl": "https://image.dev.queenit.kr/product/asset/v1/upload/da8db4945e19456aa3c4ced7fa5e12e5.png",
"expiredAtMillis": 1723425701216
}
Shell
복사
2.
응답 받은 url 에 제한시간 내에 PUT 메소드에 이미지 파일을 binary 형태로 요청주시면 됩니다.
•
요청 바디 : 이미지 파일
•
요청 헤더에는 "Content-Type" : "image/jpeg" (png 인 경우에는 image/png 로 넣어주시면 됩니다.)
•
구현 샘플 코드는 아래와 같습니다.