Xsolla-logo

为商品创建折扣促销活动

post/v2/project/{project_id}/admin/promotion/item

为商品创建折扣促销活动。

促销活动提供商品折扣(%)。 折扣将应用于指定商品的所有价格。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

项目ID。

Example: 44056
Request Body schema: application/json

包含促销活动数据的对象。

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

商品SKU。

required
object or null
percent
required
string
Default: "10.00"

百分比折扣。 商品价格将按照此百分比打折，然后四舍五入到小数点后两位。

required
object

促销活动名称。应包含键/值对， 其中键是格式为"^[a-z]{2}-[A-Z]{2}$"的区域设置，值是字符串。

property name*
additional property
string
Array of objects [ 1 .. 100 ] items

与用户属性值进行比较的条件。 必须满足所有条件操作才生效。

Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

用户属性代码。

operator
required
string

按条件执行的操作类型。

Enum: Description
eq

等于

ge

大于或等于

gt

大于

le

小于或等于

lt

小于

ne

不等于

value
required
string <= 255 characters

与用户属性值进行比较的条件值。类型取决于属性类型。

type
required
string

用户属性类型。

Enum: "string" "date" "number"
date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

促销活动结束日期。可以是null。

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

促销活动开始日期。

object

促销活动限制。

per_user
integer or null

针对单独用户的促销活动限制。

object or null

限制次数刷新周期。

object or object or object
One of:

每天类型的用户限制次数刷新。

interval_type
required
string

循环刷新周期。

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

所需时区的限制次数刷新时间（四舍五入到小时）。

Responses
201

促销活动已成功创建。

401

基本认证未通过或错误。确保您使用了基本认证或正确的凭据。

422

无效的请求。

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": [
    ],
  • "name": {
    }
}
Response samples
application/json
{
  • "promotion_id": 2384756
}