v2.media_space.upload_image
POST /api/v2/media_space/upload_image
Dùng API này để tải lên nhiều tệp ảnh (tối đa 9 ảnh).
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/media_space/upload_image
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| image | file | True | Tệp ảnh. Tối đa 10.0 MB mỗi ảnh. Định dạng chấp nhận: JPG, JPEG, PNG. Số ảnh phải ít hơn 9. | |
| scene | string | False | The scene where the picture is used, The value range is normal or desc; normal: we will process the image as a square image, it is recommended to use when uploading item image; desc: we will not process the image, it is recommended to use when uploading the image of extend_description, if you do not upload this field, it will be normal. | |
| ratio | string | False | 3:4 | Chỉ áp dụng cho người bán trong danh sách trắng. Chỉ hỗ trợ 1:1 và 3:4. Mặc định là 1:1. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| warning | string | Thông báo cảnh báo bạn cần lưu ý. | |
| request_id | string | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. | |
| response | object | ||
| image_info | object | ||
| image_id | string | ID ảnh | |
| image_url_list | object[] | URL ảnh theo từng khu vực | |
| image_url_region | string | Khu vực của URL ảnh | |
| image_url | string | URL ảnh | |
| image_info_list | object[] | ||
| id | int32 | Chỉ số của ảnh | |
| error | string | Cho biết loại lỗi nếu quá trình xử lý tải ảnh tại chỉ số này gặp lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu quá trình xử lý tải ảnh tại chỉ số này gặp lỗi. Rỗng nếu không có lỗi. | |
| image_info | object | ||
| image_id | string | ID ảnh | |
| image_url_list | object[] | URL ảnh theo từng khu vực | |
| image_url_region | string | Khu vực của URL ảnh | |
| image_url | string | URL ảnh |