GET Get Attributes
Get Attributes Shop Scope yêu cầu: seller.product.basic Truy xuất các thuộc tính sản phẩm và thuộc tính bán hàng tiêu chuẩn tích hợp sẵn để đăng một sản phẩm trong một danh mục cụ thể dựa trên vị trí cửa hàng của bạn. Các sản phẩm trên TikTok Shop được nhóm thành các danh mục được TikTok Shop định nghĩa trước, và mỗi danh mục được liên kết với một tập hợp tiêu chuẩn gồm các thuộc tính sản phẩm và thuộc tính bán hàng.
- Thuộc tính bán hàng (ví dụ: kích cỡ, màu sắc, chiều dài) xác định các biến thể sản phẩm và là tùy chọn nếu sản phẩm của bạn đơn giản và không có biến thể.
- Thuộc tính sản phẩm (ví dụ: nhà sản xuất, quốc gia xuất xứ, vật liệu sử dụng) mô tả sản phẩm như một tổng thể, không phân biệt biến thể. Một số thuộc tính sản phẩm là bắt buộc dựa trên các chính sách đăng sản phẩm. Sử dụng API này để xác định các thuộc tính bắt buộc và tùy chọn trước khi đăng một sản phẩm. Lưu ý: Nó phải là một danh mục lá (leaf category)
tương ứng với loại cây danh mục được chỉ định trong thuộc tính category_version. Version 202309
GET/product/202309/categories/{category_id}/attributes
Request
Path
| Properties | Type | Description |
|---|---|---|
| category_id Required | string | ID của danh mục của sản phẩm này. Nó phải là một danh mục lá (leaf category). |
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 giá trị này để chuyển đổi sang giờ địa phương. |
| locale | string | Mã locale BCP-47 để hiển thị thông tin danh mục.Mặc định: Locale mặc định của cửa hàng của bạn.Các giá trị có thể:- 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 |
| category_version | string | Lọc các danh mục theo phiên bản cây danh mục.Các giá trị có thể dựa trên 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 cửa hàng 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.Mặc định: v1 |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin cửa hàng khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các cửa hàng 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 thông báo. |
| 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 | | --- | --- | | 12052023 | Category does not exist | | 12052024 | Category is not final category | | 12052025 | The category is invalid | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052230 | Category version and categoryID are not matched. | | 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