POST Recommend Category
Đề xuất Danh mục Shop Scope bắt buộc: seller.product.basic Truy xuất danh mục được đề xuất cho một sản phẩm ứng viên dựa trên tiêu đề, mô tả và hình ảnh của sản phẩm đó. Nếu bạn đang đồng bộ danh mục sản phẩm từ một hệ thống bên ngoài sang TikTok Shop, hãy dùng API này để hỗ trợ việc phân loại sản phẩm. Lưu ý: Ngôn ngữ được dùng trong các trường văn bản như mô tả và tiêu đề phải khớp với ngôn ngữ của thị trường mục tiêu (ví dụ: không dùng tiếng Trung). Version 202309
POST/product/202309/categories/recommend
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| 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 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 API request đế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 dùng trên tất cả các API request. Lập trình viên có thể dùng cái này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Dùng property này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| product_title Required | string | Tiêu đề sản phẩm. Độ dài tiêu đề:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - BR, MX: [1, 300]- Các khu vực khác: [25, 255] | ||||||||||||||||||||||||||||||
| description | string | Mô tả sản phẩm ở định dạng HTML.Lưu ý:- Nội dung phải tuân theo cú pháp HTML. Tất cả các thẻ HTML đều được chấp nhận nhưng để tối ưu hiển thị trên trang chi tiết sản phẩm của TikTok Shop, hệ thống sẽ tự động chuyển đổi một số thẻ nhất định sang các định dạng thay thế, chẳng hạn như hiển thị thẻ dưới dạng hình ảnh.- Độ dài tối đa: 10,000 ký tự.- Hướng dẫn về hình ảnh: Bạn phải dùng TikTok Shop image URL. Tối đa 30 thẻ
Example CurlGoNode.jsJavaEnable word wrap Response Parameters
Example JSONEnable word wrap Error Code View common error codes | Code | Message | | --- | --- | | 12019006 | product description is invalid | | 12019009 | product image list is invalid | | 12019064 | No matching categories. Provide the full name of your product, edit its product properties, and try again. | | 12052013 | The product description cannot exceed maximum characters | | 12052051 | The product name exceed max limit characters | | 12052056 | The num of image in description cannot exceed max limit | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 12052261 | product name is empty | | 12052262 | Chinese characters are not supported in product name | | 12052266 | The product name contains non-English characters. | | 12052300 | product main image uri illegal | | 12052301 | Width and length of main image must be at least {{min_limit}}, check uri {{uri}} | | 12052305 | The main images aspect ratio cannot exceed max limit. | | 12052306 | main product images count exceed limit | | 12052340 | product description image uri illegal | | 12052341 | The description images size cannot exceed limit. | | 12052343 | Product description image format not support. | | 12052345 | The product description html tag not support. | | 12052346 | The product description has Chinese characters | | 12052348 | The product description html tag required attribute is miss. | | 12052349 | The product description html tag not support nest. | | 12052350 | The product description html tag contain illegal attribute. | | 12052351 | The product description contains non-English characters. | | 12052352 | The product description nest exceeding limit | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 12052722 | The image URI does not exist in TikTok Shop. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052912 | No matching category found within your account's main category. Check your main category in the seller profile on Seller Center and ensure your product falls within its scope. | | 12052931 | The title must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., ). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). | Nội dung này có hữu ích không?Hữu ích Không hữu ích PreviousNext |