v2.add_on_deal.add_add_on_deal
POST /api/v2/add_on_deal/add_add_on_deal
Add Add-on Deal
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/add_on_deal/add_add_on_deal
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| 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 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| add_on_deal_name | string | True | add on deal name test | Title of the add on deal |
| start_time | int | True | 1624864213 | The time when add on deal activity start. |
| end_time | int | True | 1625382613 | The time when add on deal activity end |
| promotion_type | int | True | 0 | The type of add on deal：add on discount =0；gift with mini spend=1 |
| purchase_min_spend | float | False | 11.1 | The minimum purchase amount that needs to be met to buy the gift with min.Spend |
| per_gift_num | int | False | 11 | Number of gifts that buyers can get |
| promotion_purchase_limit | int | False | 12 | promotion_purchase_limit |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | add_on.add_on_deal_start_time_error | Error code |
| message | string | The start time should be 1 hour later than current time | The description of error code |
| request_id | string | c4fbe50a634200235c10a2b3e95ae99a | The identifier of the API request for error tracking |
| response | object | ||
| add_on_deal_id | int | 20142 | Shopee's unique identifier for an add on deal activity. |