POST Optimized Images
Optimized Images Shop Required scope: seller.product.basic Tối ưu hóa hình ảnh được sử dụng trong TikTok Shop của bạn bằng cách đổi nền thành màu trắng. Điều này đặc biệt hữu ích đối với hình ảnh hiển thị trong thư viện ảnh sản phẩm vì nó giúp tăng khả năng hiển thị của sản phẩm. Lưu ý:
- Các hình ảnh cần tối ưu hóa phải được tải lên TikTok Shop trước thông qua Upload Product Image API
. Bạn sẽ không thể tối ưu hóa bất kỳ hình ảnh nào không được lưu trữ bởi TikTok Shop.
- Các hình ảnh đã được tối ưu hóa trước đó sẽ không được xử lý lại.
- Quá trình tối ưu hóa được xử lý không đồng bộ và thường hoàn tất trong vài giây. Do đó, optimize_status được trả về trong yêu cầu API đầu tiên cho một hình ảnh luôn là PROCESSING, cho biết rằng quá trình tối ưu hóa đang diễn ra. Vui lòng gọi lại API sau vài giây để nhận trạng thái tối ưu hóa cuối cùng. Version 202404
POST/product/202404/images/optimize
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
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 đến 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 nó để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| images | []object | Danh sách các hình ảnh cần tối ưu hóa. Sử dụng Upload Product Image API để tải hình ảnh lên trước và lấy các image URI tương ứng.Số lượng tối đa: 200 |
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 | | --- | --- | | 12019065 | Image URI không hợp lệ. Vui lòng sử dụng URI được tạo bởi Upload Product Image API. | | 12019070 | Chế độ tối ưu hóa không hợp lệ. | | 12038007 | Số lượng image URI vượt quá giới hạn 200. | | 12052722 | Image URI không tồn tại trong TikTok Shop. |
Is this content helpful?Helpful
Not Helpful
PreviousNext