v2.global_product.update_tier_variation
POST /api/v2/global_product/update_tier_variation
Cập nhật tier variation sản phẩm toàn cầu. Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc. API này chỉ có thể được dùng mà không thay đổi cấu trúc tier. Bạn có thể thêm tùy chọn, xóa tùy chọn và cập nhật hình ảnh tùy chọn qua API này.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/update_tier_variation
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ả |
|---|---|---|---|---|
| global_item_id | int64 | True | 2200146923 | ID của sản phẩm toàn cầu. |
| model_list | object[] | False | ||
| model_id | int64 | True | 1002066586922 | ID của model. |
| tier_index | int32 | True | tier_variation của model. | |
| standardise_tier_variation | object[] | False | Tier variation chuẩn hóa của sản phẩm. Phải có ít nhất một trong standardise_tier_variation và tier_variation. | |
| variation_id | int | True | ID tier variation chuẩn hóa. | |
| variation_name | string | False | Tên tier variation chuẩn hóa. | |
| variation_group_id | int | False | ID nhóm tier variation chuẩn hóa. | |
| variation_option_list | object[] | True | Danh sách tùy chọn tier variation chuẩn hóa. | |
| variation_option_id | int | True | ||
| variation_option_name | string | False | ||
| image_id | string | False |
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 | Thông báo cảnh báo. | |
| request_id | string | 98eae35efff24dd0974c21a847127184 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
, { "variation_option_id": 0, "variation_option_name": "Blue stripe", "image_id": "img-blue" }, { "variation_option_id": 0, "variation_option_name": "Mint stripe", "image_id": "img-mint" } ] }, { "variation_id": 0, "variation_group_id": 0, "variation_name": "Size", "variation_option_list": [ { "variation_option_id": 0, "variation_option_name": "S" }, { "variation_option_id": 0, "variation_option_name": "M" }, { "variation_option_id": 0, "variation_option_name": "L" } ] } ], "model": [ { "tier_index": [0,0], "model_sku": "SKU-Cream-S", "original_price": 100000, "seller_stock": [{"stock":3}] }, { "tier_index": [0,1], "model_sku": "SKU-Cream-M", "original_price": 100000, "seller_stock": [{"stock":2}] }, { "tier_index": [0,2], "model_sku": "SKU-Cream-L", "original_price": 100000, "seller_stock": [{"stock":0}] }, { "tier_index": [1,0], "model_sku": "SKU-Blue-S", "original_price": 100000, "seller_stock": [{"stock":1}] }, { "tier_index": [1,1], "model_sku": "SKU-Blue-M", "original_price": 100000, "seller_stock": [{"stock":4}] }, { "tier_index": [1,2], "model_sku": "SKU-Blue-L", "original_price": 100000, "seller_stock": [{"stock":3}] }, { "tier_index": [2,0], "model_sku": "SKU-Mint-S", "original_price": 100000, "seller_stock": [{"stock":1}] }, { "tier_index": [2,1], "model_sku": "SKU-Mint-M", "original_price": 100000, "seller_stock": [{"stock":2}] }, { "tier_index": [2,2], "model_sku": "SKU-Mint-L", "original_price": 100000, "seller_stock": [{"stock":5}] } ] "global_item_id": 100918870 }