v2.global_product.get_brand_list
GET /api/v2/global_product/get_brand_list
Dùng API này để lấy danh sách thương hiệu. Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/get_brand_list
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ả |
|---|---|---|---|---|
| offset | int | True | 1 | Xác định mục bắt đầu của dữ liệu trả về. Mặc định là 0. Nếu dữ liệu nhiều hơn một trang, có thể dùng offset để bắt đầu lần gọi tiếp theo. |
| page_size | int | True | 10 | Kích thước một trang. |
| category_id | int | True | 12345 | ID danh mục. |
| status | int | True | 1 | Trạng thái thương hiệu: 1 - thương hiệu thông thường, 2 - thương hiệu đang chờ duyệt. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| warning | string | Cho biết chi tiết cảnh báo nếu có. Để trống nếu không có cảnh báo. | |
| request_id | string | 7b9da0c6926642199c33ee9dd3a266f5 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | ||
| brand_list | object[] | ||
| brand_id | int | 0 | ID của thương hiệu. |
| original_brand_name | string | nike | Tên gốc của thương hiệu. |
| display_brand_name | string | nike | Tên hiển thị của thương hiệu. |
| has_next_page | boolean | Cho biết danh sách sản phẩm có nhiều hơn một trang không. Nếu giá trị này là true, bạn nên tiếp tục kiểm tra trang tiếp theo. | |
| next_offset | int | Nếu has_next_page là true, giá trị này cần được đặt vào request.offset cho lần gọi tiếp theo. | |
| is_mandatory | boolean | Có bắt buộc hay không. | |
| input_type | string | Kiểu nhập liệu: DROP_DOWN. |