POST Upload Product File
Tải lên Tệp Sản phẩm Seller Required scope: seller.product.basic Tải lên các tệp không phải hình ảnh, chẳng hạn như PDF hoặc video lên TikTok Shop. Sử dụng API này khi bạn cần thêm video vào sản phẩm để cải thiện trải nghiệm mua sắm, hoặc gửi các chứng nhận hoặc báo cáo để đáp ứng yêu cầu của TikTok Shop đối với việc đăng bán các sản phẩm bị hạn chế. Lưu ý: Bạn phải lưu trữ phần thân phản hồi để truy xuất ID hoặc URL cần thiết nhằm liên kết tệp với một 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/files/upload
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: multipart/form-data |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
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 giá trị này để chuyển đổi sang giờ địa phương. |
Body
| Properties | Type | Description |
|---|---|---|
| data Required | file | Tệp cục bộ cần được tải lên.Lưu ý：- Các định dạng được hỗ trợ: PDF, MP4, MOV, MKV, WMV, WEBM, AVI, 3GP, FLV, MPEG- Kích thước PDF tối đa: 20 MB- Kích thước video tối đa: 100 MB- Tỷ lệ khung hình video: 9:16 đến 16:9Khuyến nghị cho video sản phẩm:- Tỷ lệ khung hình: 1:1 - Độ phân giải: HD 720p hoặc cao hơn- Thời lượng: 20 - 60 giây |
| name Required | string | Tên của tệp, bao gồm phần mở rộng tệp (ví dụ certification.pdf)Lưu ý:- Không sử dụng các dấu chấm bổ sung, ngoại trừ dấu chấm đứng trước phần mở rộng tệp.- Không bắt đầu tên bằng ký hiệu.- Không bao gồm khoảng trắng. |
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 | Các 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 | | --- | --- | | 12019103 | Couldn't upload file, the file is empty. | | 12019104 | The file name is empty. | | 12019105 | Failed to process the file. The format or content is not supported. | | 12019122 | The video ratio must be between 9:16 and 16:9. | | 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. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext