v2.add_on_deal.get_add_on_deal_list
GET /api/v2/add_on_deal/get_add_on_deal_list
Lấy Danh Sách Chương Trình Mua Kèm Giảm Giá
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/add_on_deal/get_add_on_deal_list
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Mã đối tác được cấp 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ấu 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 dùng để truy cập API, xác định quyền truy cập của bạn. Có thể dùng nhiều lần, hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của shop trên Shopee. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán 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ả |
|---|---|---|---|---|
| promotion_status | string | True | all | Trạng thái của chương trình mua kèm giảm giá, mặc định là all |
| page_no | int | False | 1 | Số trang mặc định là 1 |
| page_size | int | False | 100 | Kích thước trang mặc định là 100 |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Mã lỗi | |
| message | string | Mô tả mã lỗi | |
| request_id | string | dc46d78810be446693995d31d03312c0 | Mã định danh yêu cầu API dùng để theo dõi lỗi |
| response | object | ||
| add_on_deal_list | object[] | Danh sách mã chương trình mua kèm giảm giá | |
| start_time | int | 1617105600 | Thời gian bắt đầu chương trình mua kèm giảm giá. |
| end_time | int | 1617195600 | Thời gian kết thúc chương trình mua kèm giảm giá |
| promotion_type | int | 0 | Loại chương trình mua kèm giảm giá：giảm giá mua kèm =0；quà tặng khi đủ chi tiêu tối thiểu=1 |
| purchase_min_spend | float | 3.0 | Số tiền mua tối thiểu cần đạt để nhận quà tặng khi đủ chi tiêu tối thiểu |
| add_on_deal_id | int | 20183 | Mã định danh duy nhất của chương trình mua kèm giảm giá trên Shopee. |
| per_gift_num | int | 1 | Số lượng quà tặng mà người mua có thể nhận |
| promotion_purchase_limit | int | 12 | Số lượng tối đa sản phẩm mua kèm mà khách hàng có thể mua trong mỗi đơn hàng. |
| add_on_deal_name | string | Bundle deal name test | Tiêu đề của chương trình mua kèm giảm giá |
| source | int | 1 | Nguồn tạo chương trình mua theo bộ：Người bán=1，shopee admin=0 |
| sub_item_prioriry | int[] | [100862950,100863523] | Thứ tự hiển thị của sản phẩm phụ phía người mua |
| more | boolean | true | Cho biết danh sách khuyến mãi có nhiều hơn một trang không. Nếu giá trị này là true, hãy tiếp tục kiểm tra trang tiếp theo để lấy phần còn lại của danh sách. |