v2.global_product.get_attribute_tree
GET /api/v2/global_product/get_attribute_tree
Lấy cây thuộc tính mtsku cho các danh mục.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/get_attribute_tree
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| merchant_id | int | 1 | Mã định danh duy nhất của Shopee cho một merchant. Bắt buộc cho mọi yêu cầu cấp merchant (người dùng CB CNSC gọi các API liên quan đến sản phẩm toàn cầu). |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, merchant_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| category_id_list | int[] | True | Số lượng tối đa là 20. | |
| language | string | False | "en" | Ngôn ngữ. Các ngôn ngữ hỗ trợ: "SG": ["en", "zh-Hans", "ms"], "MY": ["en", "zh-Hans", "ms"], "PH": ["en", "zh-Hans"], "VN": ["vn", "en"], "ID": ["id", "en"], "TH": ["th", "en"], "BR": ["pt-BR", "en"], "MX": ["es-MX", "en"], "CO": ["es-CO", "en"], "CL": ["es-CL", "en"], "TW": ["zh-Hant", "zh-Hans", "en"], "IN": ["en", "hi"] |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Lỗi. | |
| message | string | Thông báo. | |
| warning | string | Cảnh báo. | |
| request_id | string | ID yêu cầu. | |
| response | object | Phản hồi. | |
| list | object[] | Mỗi kết quả tương ứng với một danh mục trong category_ids. | |
| attribute_tree | object[] | Cây thuộc tính của một danh mục. | |
| attribute_id | int | ID thuộc tính. | |
| mandatory | boolean | Có bắt buộc hay không. | |
| name | string | Tên thuộc tính. | |
| attribute_value_list | object[] | Tất cả các giá trị có thể dùng cho thuộc tính này. | |
| value_id | int | ID giá trị. | |
| name | string | Tên giá trị. | |
| value_unit | string | Đơn vị giá trị. | |
| child_attribute_list | object[] | Các thuộc tính con của giá trị thuộc tính cha. Cấu trúc nội dung giống với attribute_tree. | |
| multi_lang | object | Kết quả dịch để hiển thị tên giá trị. | |
| language | string | Ngôn ngữ. | |
| value | string | Kết quả dịch. | |
| attribute_info | object | Thông tin bổ sung của thuộc tính. | |
| input_type | int | SINGLE_DROP_DOWN = 1, SINGLE_COMBO_BOX = 2, FREE_TEXT_FILED = 3, MULTI_DROP_DOWN = 4, MULTI_COMBO_BOX = 5. | |
| input_validation_type | int | VALIDATOR_NO_VALIDATE_TYPE = 0, VALIDATOR_INT_TYPE = 1, VALIDATOR_STRING_TYPE = 2, VALIDATOR_FLOAT_TYPE = 3, VALIDATOR_DATE_TYPE = 4. | |
| format_type | int | FORMAT_NORMAL = 1, FORMAT_QUANTITATIVE_WITH_UNIT = 2. | |
| date_format_type | int | YEAR_MONTH_DATE = 0 (DD/MM/YYYY), YEAR_MONTH = 1 (MM/YYYY). | |
| attribute_unit_list | string[] | Danh sách đơn vị có thể dùng cho thuộc tính. | |
| mandatory_region | string[] | Thuộc tính là bắt buộc cho các khu vực này. | |
| max_value_count | int | Số lượng giá trị được chọn tối đa. | |
| introduction | string | Giới thiệu về thuộc tính đặc biệt. | |
| is_oem | boolean | ||
| support_search_value | boolean | Cho biết thuộc tính này có giá trị có thể tìm kiếm hay không. Nếu có, hãy gọi v2.global_product.search_global_attribute_value_list để lấy các giá trị mặc định. | |
| multi_lang | object[] | Kết quả dịch để hiển thị tên thuộc tính. | |
| language | string | Ngôn ngữ. | |
| value | string | Kết quả dịch. | |
| category_id | int | ID danh mục. | |
| warning | string | Thông báo cảnh báo. |