v2.discount.get_sip_discounts
GET /api/v2/discount/get_sip_discounts
Lấy Giảm giá Nước ngoài SIP. Chỉ các khu vực có giảm giá sắp tới/đang diễn ra mới được trả về. Vui lòng sử dụng Shop ID của cửa hàng chính để gửi yêu cầu, API sẽ trả về danh sách các cửa hàng liên kết thuộc cửa hàng chính này đã thiết lập giảm giá, cùng với chi tiết giảm giá.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/discount/get_sip_discounts
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác đượ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ấ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 để truy cập API, dùng để xác định quyền của bạn với API. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Đị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 | Chữ ký được tạo bởi partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết hơn: 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ả |
|---|---|---|---|---|
| region | string | False | SG | Khu vực của cửa hàng liên kết SIP cần lấy thông tin giảm giá. Nếu không truyền, sẽ trả về thông tin giảm giá đã thiết lập cho tất cả các cửa hàng liên kết SIP. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | Định danh của yêu cầu API để theo dõi lỗi. | |
| error | string | Loại lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| message | string | Chi tiết lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| response | object | ||
| discount_list | object[] | Danh sách giảm giá theo từng khu vực. Sẽ được lọc dựa trên tham số yêu cầu "region". | |
| region | string | SG | Khu vực của cửa hàng liên kết SIP. |
| status | string | ongoing | Trạng thái giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, có thể là upcoming/ongoing, không bao gồm giảm giá đã hết hạn. |
| sip_discount_rate | int32 | 10 | Tỷ lệ giảm giá được thiết lập cho cửa hàng liên kết SIP tại khu vực hiện tại. |
| start_time | timestamp | 1741235212 | Thời gian bắt đầu giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |
| end_time | timestamp | 1756787212 | Thời gian kết thúc giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |
| create_time | timestamp | 1741233412 | Thời gian tạo giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |
| update_time | timestamp | 1741233412 | Thời gian cập nhật mới nhất của giảm giá cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |