v2.ams.batch_add_products_to_open_campaign

POST /api/v2/ams/batch_add_products_to_open_campaign

Batch add products to the Open Campaign for a given danh sách product IDs

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ams/batch_add_products_to_open_campaign

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	[123]	The danh sách item_id, max limit: 50
commission_rate	float	True	1.1	Tỷ lệ hoa hồng, 1.1 nghĩa là 1.1%, hỗ trợ hai chữ số thập phân
period_start_time	timestamp	False	1735660800	Thời gian bắt đầu kỳ, tính bằng giây, nếu thiếu sẽ đặt sau 10 phút
period_end_time	timestamp	False	1735660800	Period thời gian kết thúc, tính bằng giây, if missing, will set 32503651199 (2999-12-31 23:59:59) represent of no limit

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string	error_business	Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string	Please agree to the AMS T&C in Seller Center - Affiliate Marketing Solutions first before using Open API.	Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
request_id	string	b937c04e554847789cbf3fe33a0ad5f1	Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object
failed_list	object[]
item_id	int64	123	ID sản phẩm
fail_error	string	invalid_param	Fail Error
fail_message	string	The commission rate is invalid, please check again.	Fail Message
success_list	int64[]	[123]	Success ID sản phẩm List

Dữ liệu gửi

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/ams/batch\_add\_products\_to\_open\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp") .header("Content-Type","application/json") .body("{ "commission_rate": 1.1, "item_id_list": [ 123 ], "period_end_time": 1735660800, "period_start_time": 1735660800 }") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/ams/batch\_add\_products\_to\_open\_campaign?access\_token=access\_token&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 => 'POST', CURLOPT_POSTFIELDS => '{ "commission_rate": 1.1, "item_id_list": [ 123 ], "period_end_time": 1735660800, "period_start_time": 1735660800 }', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request POST 'https://partner.shopeemobile.com/api/v2/ams/batch\_add\_products\_to\_open\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp'
--header 'Content-Type: application/json'
--data-raw '{ "commission_rate": 1.1, "item_id_list": [ 123 ], "period_end_time": 1735660800, "period_start_time": 1735660800 }' import requests import json url = "https://partner.shopeemobile.com/api/v2/ams/batch\_add\_products\_to\_open\_campaign?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp" payload=json.dumps({ "commission_rate": 1.1, "item_id_list": [ 123 ], "period_end_time": 1735660800, "period_start_time": 1735660800 }) headers = { 'Content-Type': 'application/json' } response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

}

] } }