POST Upload Product Image
Tải lên hình ảnh sản phẩm Seller Required scope: seller.product.basic Tải lên hình ảnh cục bộ lên TikTok Shop để sử dụng làm hình ảnh sản phẩm, hình ảnh biến thể, bảng kích thước, hình ảnh chứng nhận, v.v.
Lưu ý:
- Tất cả hình ảnh được sử dụng trong sản phẩm TikTok Shop phải được tải lên thông qua API này. Bạn sẽ không thể sử dụng bất kỳ URL hình ảnh nào không được lưu trữ bởi TikTok Shop.
- Bạn phải lưu trữ phần thân phản hồi để lấy ID hoặc URL cần thiết để liên kết hình ảnh với sản phẩm trong quá trình tạo hoặc chỉnh sửa sản phẩm. Version 202309
POST/product/202309/images/upload
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: multipart/form-data |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể sử dụng để chuyển đổi sang giờ địa phương. |
Body
| Properties | Type | Description |
|---|---|---|
| data Required | file | Tệp hình ảnh cục bộ cần tải lên.Lưu ý:- Các định dạng được hỗ trợ: JPG, JPEG, PNG, WEBP, HEIC, BMP- Kích thước tối đa: 10MB- Kích thước ảnh: [100x100 px, 20000x20000 px]- Đối với use_case=MAIN_IMAGE, kích thước ảnh phải nằm trong khoảng từ 300x300 px đến 4000x4000 px.- Đối với use_case=SIZE_CHART_IMAGE, kích thước phải ít nhất 1024 px ở cạnh ngắn hơn. |
| use_case | string | Tình huống sử dụng của hình ảnh.Các giá trị có thể:- MAIN_IMAGE: Hình ảnh hiển thị trong thư viện hình ảnh sản phẩm.- ATTRIBUTE_IMAGE: Hình ảnh đại diện cho một biến thể sản phẩm (ví dụ: màu sắc).- DESCRIPTION_IMAGE: Hình ảnh được sử dụng trong mô tả sản phẩm.- CERTIFICATION_IMAGE: Hình ảnh để cung cấp thông tin hỗ trợ nhằm đáp ứng các yêu cầu của TikTok Shop khi đăng bán các sản phẩm bị hạn chế (ví dụ: hình ảnh chứng nhận, bao bì sản phẩm, nhãn mác).- SIZE_CHART_IMAGE: Hình ảnh hiển thị chi tiết số đo của sản phẩm.Lưu ý: Hình ảnh cho các tình huống sử dụng MAIN_IMAGE và ATTRIBUTE_IMAGE không nằm trong phạm vi tỷ lệ khung hình từ 3:4 đến 4:3 sẽ tự động được chuyển đổi sang 1:1. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 11050001 | invalid param | | 12019116 | The image dimensions exceed the allowed limits. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12038002 | Invalid upload file. Please ensure you are passing the correct file data. | | 12038004 | Failed to process the image. The format or content is not supported. | | 12038005 | The file size exceeds the maximum allowed size. | | 12038014 | The image dimensions exceed the allowed limits. Allowed dimensions (width x height in pixels): {{min_width}} x {{min_height}} to {{max_width}} x {{max_height}} | | 12038015 | Failed to process the image. The format or content is not supported. Supported formats: {{formats}} |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext