GET Get Global Categories
Get Global Categories Seller Scope bắt buộc: seller.global_product.category.info Truy xuất tất cả danh mục sản phẩm khả dụng, bất kể sự khác biệt theo thị trường. Danh mục sản phẩm được cập nhật thường xuyên, vì vậy 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 global product. Version 202309
GET/product/202309/global_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 seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 API request đến TTS, bạn phải ký chúng để TTS có thể nhận diện được 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 API request. Nhà phát triển có thể 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 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ó 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 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.Mặc định: v1 |
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 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