v2.follow_prize.update_follow_prize
POST /api/v2/follow_prize/update_follow_prize
update_follow_prize
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/follow_prize/update_follow_prize
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 |
|---|---|---|---|---|
| follow_prize_name | string | False | shop_follow_prize | The name of the follow prize,The follow prize name length max limit is 20. |
| campaign_id | int32 | True | 123344 | The unique identifier for the created follow prize. |
| start_time | timestamp | False | 1655341211 | The timing from when the follow prize is valid,the start time later than the current time.If the start time and end time passed in by the seller overlap with other upcoming/ongoing activities, it will prompt "Another Follow Prize voucher already exists during this time period, please set another period." |
| end_time | timestamp | False | 1657760411 | The timing until when the follow prize is still valid,the end time must be greater than the start time by at least 1 day and end time cannot exceed 3 months after start time.If the start time and end time passed in by the seller overlap with other upcoming/ongoing activities, it will prompt "Another Follow Prize voucher already exists during this time period, please set another period." |
| usage_quantity | int32 | False | 2000 | Please enter a value between 1 and 200000. |
| min_spend | float | False | The minimum spend required for using this follow prize. |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| response | object | Detailed informations you are querying. | |
| campagin_id | int32 | 123344 | The unique identifier for the created follow prize. |
| error | string | Indicate error type if hit error. Empty if no error happened. | |
| message | string | Indicate error details if hit error. Empty if no error happened. | |
| request_id | string | bf3197ba056a884119dd8aea3d89dcb5 | The identifier of the API request for error tracking. |