Chuyển tới nội dung chính

v2.product.get_model_list

GET /api/v2/product/get_model_list

Get model danh sách an item.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/product/get_model_list

Tham số chung

TênKiểuMẫuMô tả
partner_idint1Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamptimestamp1610000000Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

TênKiểuBắt buộcMẫuMô tả
item_idint64True178312ID của the item

Tham số Response

TênKiểuMẫuMô tả
messagestringChi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
warningstringWarning message.
request_idstring75c2b01e50764cec8cfdc61e75c1f26dMã định danh của yêu cầu API dùng để theo dõi lỗi.
responseobject
tier_variationobject[]Variation config of item.
option_listobject[]Option list.
optionstringtestsku1Option name.
imageobject
image_idstringId of image
image_urlstringUrl of image.
namestringTên biến thể.
modelobject[]Model list.
price_infoobject[]Price info. For SG/MY/BR/MX/PL/ES/AR seller: Sellers can set the price with two decimal place, other regions can only set the price as an integer.
currencystringTWDCurrency for the item price.
current_pricefloat100.0Giá hiện tại of item.
original_pricefloat100.0Giá gốc of item.
inflated_price_of_original_pricefloat100.0Giá gốc of item after tax.
inflated_price_of_current_pricefloat100.0Giá hiện tại of item after tax.
sip_item_pricefloat100.0SIP item price. If item is from SIP primary shop, this field will be returned.
sip_item_price_sourcestringmanualSIP item price source, could be manual or auto.If item is from SIP primary shop, this field will be returned.
sip_item_price_currencystringCNYThe currency of sip_item_price.If item is from SIP primary shop, this field will be returned.
local_pricefloat122.02The giá gốc multiplied by the local adjustment rate equals the local price. The local price is denominated in the local currency and is rounded to two decimal places. <path></path>
local_promotion_pricefloat122.02During the promotion period, the CB price is multiplied by the local adjustment rate. Once the promotion starts, the price remains unchanged. During the promotion, the local_promotion_price= current_price, which is denominated in the local currency and retained to two decimal places. <path></path>
model_idint642000458802ID biến thể.
tier_indexint32[][0, 1]Tier index of this model.
promotion_idint640Current promotion ID of this model.
has_promotionbooleantrueIndicates whether the model is currently under any ongoing promotion.
model_skustringblue bagSKU of this model. the length should be under 100.
model_statusstringMODEL_NORMALThe model status. Should be MODEL_NORMAL or MODEL_UNAVAILABLE. MODEL_NORMAL models can be sold on the buyer's side, and MODEL_UNAVAILABLE models cannot be sold on the buyer's side.
pre_orderobject(Only whitelisted users can use)
is_pre_orderbooleanfalseĐặt hàng trước.
days_to_shipint323The số ngày giao hàng.
stock_info_v2objectnew stock info. Please check this FAQ for more detail: https://open.shopee.com/faq?top=162&sub=166&page=1&faq=230
summary_infoobjectstock summary Info
total_reserved_stockint32Stock reserved for promotion. Note: For SIP P Item, will return the total reserved stock for P Item and all A Items under the P Item.
total_available_stockint32Stock can be sold currently
seller_stockobject[]Seller-managed stock
location_idstringlocation id
stockint32stock in the current warehouse
if_saleablebooleantrueTo return if the stock of the location id is saleable
shopee_stockobject[]Shopee warehouse stock
location_idstringlocation id
stockstringstock
advance_stockobjectOnly for PH/VN/ID/MY local selected shops.
sellable_advance_stockint32Refers to Advance Fulfillment stock that Seller has shipped out and is available to be used to fulfill an order.
in_transit_advance_stockint32Refers to Advance Fulfillment stock that seller has shipped out and is still in transit and unavailable to be used to fulfill an order.
gtin_codestring(Only TW seller and BR local seller available) gtin code.
weightstring"1.1"The weight of this model, the unit is KG. If don't set the weight of this model, will use the weight of item by default.
dimensionobjectThe dimension of this model. If don't set the dimension of this model, will use the dimension of item by default.
package_heightint3211The height of package for this model, the unit is CM.
package_lengthint3211The length of package for this model, the unit is CM.
package_widthint3211The width of package for this model, the unit is CM.
is_fulfillment_by_shopeebooleanwhether model is fulfillment by shopee
standardise_tier_variationobject[]Standardise Variation config of item.
variation_idint64Standardise Variation ID
variation_namestringStandardise Variation Name
variation_group_idint64Standardise Variation Group ID
variation_option_listobject[]Standardise Variation Option List
variation_option_idint64Standardise Option ID
variation_option_namestringStandardise Option Name
image_idstringID of image
image_urlstringURL of image
errorstringLoại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/product/get\_model\_list?access\_token=access\_token&item\_id=178312&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/product/get\_model\_list?access\_token=access\_token&item\_id=178312&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request GET 'https://partner.shopeemobile.com/api/v2/product/get\_model\_list?access\_token=access\_token&item\_id=178312&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp' import requests url = "https://partner.shopeemobile.com/api/v2/product/get\_model\_list?access\_token=access\_token&item\_id=178312&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp" payload={} headers = { } response = requests.request("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

} ], "name": "-" } ], "model": [ { "price_info": [ { "currency": "TWD", "current_price": 100, "original_price": 100, "inflated_price_of_original_price": 100, "inflated_price_of_current_price": 100, "sip_item_price": 100, "sip_item_price_source": "manual", "sip_item_price_currency": "CNY" } ], "model_sku": "blue bag", "model_status": "MODEL_NORMAL", "pre_order": { "is_pre_order": false, "days_to_ship": 3 }, "stock_info_v2": { "summary_info": { "total_reserved_stock": 0, "total_available_stock": 0 }, "seller_stock": [ { "location_id": "-", "stock": 0, "if_saleable": true } ], "shopee_stock": [ { "location_id": "-", "stock": "-" } ] }, "gtin_code": "-", "weight": "1.1", "dimension": { "package_height": 11, "package_length": 11, "package_width": 11 }, } ], "standardise_tier_variation": [ { "variation_name": "-", "variation_option_list": [ { "variation_option_name": "-", "image_id": "-", "image_url": "-" } ] } ] }, "error": "-" }