GET Get Categories
Get Categories Shop Scope bắt buộc: seller.product.basic Lấy danh sách các danh mục sản phẩm khả dụng cho shop của bạn. Danh mục sản phẩm được cập nhật thường xuyên, vì vậy bạn nên gọi API theo thời gian thực để đảm bảo bạn đang sử dụng dữ liệu danh mục mới nhất. Việc lưu cache dữ liệu danh mục cục bộ có thể dẫn đến việc sử dụng thông tin lỗi thời, gây ra lỗi khi tạo sản phẩm. Đối với thị trường Indonesia: Để đăng một sản phẩm trên cả TikTok Shop và Tokopedia, bạn chỉ được sử dụng các danh mục có sẵn trên cả hai nền tảng. Vui lòng gọi API này hai lần để xác định các danh mục trùng nhau. Version 202309
GET/product/202309/categories
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu đượ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 riêng biệt. Vui lòng sử dụng key cụ thể được cấp 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 yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể xác định người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương. |
| locale | string | Mã locale BCP-47 để hiển thị thông tin danh mục.Default: Locale mặc định của shop của bạn.Các giá trị có thể có:- cs-CZ- de-AT- de-BE- de-DE- el-GR- en-GB- en-IE- en-US- es-ES- es-MX- fr-FR- fr-BE- hu-HU- id-ID- it-IT- ja-JP- ms-MY- nl-NL- nl-BE- pl-PL- pt-BR- pt-PT- th-TH- vi-VN- zh-CN |
| keyword | string | Lọc danh mục theo từ khóa này trong local_name. |
| category_version | string | Lọc danh mục theo phiên bản cây danh mục.Các giá trị có thể có tùy theo khu vực:- US, EU và SEA: v2, đại diện cho cây danh mục 7 cấp. Quan trọng: Đối với các shop US, EU và SEA, bạn phải truyền v2 khi sử dụng API này.- Các khu vực khác: v1, đại diện cho cây danh mục 3 cấp.Default: v1 |
| listing_platform | string | Lọc danh mục theo nền tảng được chỉ định.Các giá trị có thể có:- TIKTOK_SHOP- TOKOPEDIADefault: TIKTOK_SHOPChỉ áp dụng cho người bán đã chuyển đổi từ Tokopedia. |
| include_prohibited_categories | bool | Cờ để chỉ định có bao gồm các danh mục bị cấm trên TikTok Shop hay không. Đặt thành true để xác định những danh mục sản phẩm mà bạn không thể đăng trên TikTok Shop trong bất kỳ trường hợp nào.Chỉ áp dụng cho thị trường BR, MX, EU và SEA. |
| 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 |
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 message. |
| request_id | string | Log 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 | | --- | --- | | 12019210 | publish param invalid | | 12052023 | Category does not exist | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 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