v2.product.get_item_promotion

GET /api/v2/product/get_item_promotion

Get item promotion info.

Đường dẫn Endpoint

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

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner 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.
timestamp	timestamp	1610000000	Dù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_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token 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_id	int	600000	Mã đị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.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature 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ên	Kiểu	Bắt buộc	Mẫu	Mô tả
item_id_list	int64[]	True	13233406680,17924576533	ID sản phẩm list, can send 1 to 50 items.

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string	product.error_param	Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string		Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
warning	string		Waring message.
request_id	string		Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object
success_list	object[]		Success item promotion info.
item_id	int		The identity of product item.
promotion	object[]		Item promotion info list
promotion_type	string	Campaign	Promotion type, Các giá trị áp dụng: See Data Definition- PromotionType.
promotion_id	int64		The identity of item promotion.
model_id	int64		The identity of product model.
start_time	timestamp		Promotion start tiem.
end_time	timestamp		Promotion end item.
promotion_price_info	object[]		Promotion price info.
promotion_price	float		Promotion price.
promotion_staging	string		Could be ongoing/upcoming
promotion_stock_info_v2	object		new promotion stock
summary_info	object		stock summary info
total_reserved_stock	int32	10	Total Stock reserved for promotion
failure_list	object[]		Fail item promotion info.
item_id	int64		The identity of item.
failed_reason	string		Fail reason.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/product/get\_item\_promotion?access\_token=access\_token&item\_id\_list= 13233406680,17924576533&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\_item\_promotion?access\_token=access\_token&item\_id\_list= 13233406680,17924576533&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\_item\_promotion?access\_token=access\_token&item\_id\_list= 13233406680,17924576533&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp' import requests url = "https://partner.shopeemobile.com/api/v2/product/get\_item\_promotion?access\_token=access\_token&item\_id\_list= 13233406680,17924576533&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)

], "promotion_staging": "upcoming", "promotion_stock_info_v2": { "summary_info": { "total_reserved_stock": 0 } } }, { "promotion_type": "Discount Promotions", "promotion_id": 649305216139969, "model_id": 9182545, "start_time": 1650609000, "end_time": 1650616200, "promotion_price_info": [ { "promotion_price": 160 } ], "promotion_staging": "upcoming", "promotion_stock_info_v2": { "summary_info": { "total_reserved_stock": 20 } } }, { "promotion_type": "Discount Promotions", "promotion_id": 649305216139969, "model_id": 9182546, "start_time": 1650609000, "end_time": 1650616200, "promotion_price_info": [ { "promotion_price": 160 } ], "promotion_staging": "upcoming", "promotion_stock_info_v2": { "summary_info": { "total_reserved_stock": 20 } } } ] } ] } }