创建奖励链

包含商品本地化名称的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的语言代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

One of:

两个小写字母的语言代码。

ar	string or null 阿拉伯语
bg	string or null 保加利亚语
cn	string or null 中文（简体）
cs	string or null 捷克语
de	string or null 德语
en	string or null 英语
es	string or null 西班牙语（西班牙）
fr	string or null 法语
he	string or null 希伯来语
id	string or null 印度尼西亚语
it	string or null 意大利语
ja	string or null 日语
km	string or null 高棉语
ko	string or null 韩语
lo	string or null 老挝语
my	string or null 缅甸语
ne	string or null 尼泊尔语
ph	string or null 菲律宾语
pl	string or null 波兰语
pt	string or null 葡萄牙语
ro	string or null 罗马尼亚语
ru	string or null 俄语
th	string or null 泰语
tr	string or null 土耳其语
tw	string or null 中文（繁体）
vi	string or null 越南语

required

object

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。

date_start

required

string <date-time>

奖励链的开始日期。

required

Array of objects

Array

required

(two-letter (object or null)) or (five-letter (object or null))

One of:

两个小写字母的语言代码。

ar	string or null 阿拉伯语
bg	string or null 保加利亚语
cn	string or null 中文（简体）
cs	string or null 捷克语
de	string or null 德语
en	string or null 英语
es	string or null 西班牙语（西班牙）
fr	string or null 法语
he	string or null 希伯来语
id	string or null 印度尼西亚语
it	string or null 意大利语
ja	string or null 日语
km	string or null 高棉语
ko	string or null 韩语
lo	string or null 老挝语
my	string or null 缅甸语
ne	string or null 尼泊尔语
ph	string or null 菲律宾语
pl	string or null 波兰语
pt	string or null 葡萄牙语
ro	string or null 罗马尼亚语
ru	string or null 俄语
th	string or null 泰语
tr	string or null 土耳其语
tw	string or null 中文（繁体）
vi	string or null 越南语

required

object

amount

required

integer

以奖励积分表示的步骤价格。

required

Array of objects

Array

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。

quantity

required

integer

商品数量。

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

用户属性代码。

operator

required

string

按条件执行的操作类型。用于string属性类型。

Enum:	Description
eq	等于
ne	不等于

value

required

string <= 255 characters

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

type

required

string

用户属性类型。

Value: "string"

can_be_missing

boolean

表示即使用户属性中缺少属性仍满足条件。传递true可向不具有此属性的用户显示该项目。具有该属性但值与条件中指定的值不匹配的用户将看不到该商品。传递false则具有该属性但值与条件中指定的值不匹配或缺少该属性的用户将看不到该商品。

image_url

string or null

图像URL。

is_enabled

required

boolean

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

用户属性代码。

operator

required

string

按条件执行的操作类型。用于string属性类型。

Enum:	Description
eq	等于
ne	不等于

value

required

string <= 255 characters

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

type

required

string

用户属性类型。

Value: "string"

can_be_missing

boolean

date_end

string or null <date-time>

奖励链促销活动的结束日期。可以是null。如果date_end为null，则奖励链无时间限制。

(two-letter (object or null)) or (five-letter (object or null))

包含本地化商品描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的区域设置代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

One of:

两个小写字母的语言代码。

ar	string or null 阿拉伯语
bg	string or null 保加利亚语
cn	string or null 中文（简体）
cs	string or null 捷克语
de	string or null 德语
en	string or null 英语
es	string or null 西班牙语（西班牙）
fr	string or null 法语
he	string or null 希伯来语
id	string or null 印度尼西亚语
it	string or null 意大利语
ja	string or null 日语
km	string or null 高棉语
ko	string or null 韩语
lo	string or null 老挝语
my	string or null 缅甸语
ne	string or null 尼泊尔语
ph	string or null 菲律宾语
pl	string or null 波兰语
pt	string or null 葡萄牙语
ro	string or null 罗马尼亚语
ru	string or null 俄语
th	string or null 泰语
tr	string or null 土耳其语
tw	string or null 中文（繁体）
vi	string or null 越南语

image_url

string or null

图像URL。

is_always_visible

boolean

Default: true

奖励链是否对所有用户可见：

如为true，则无论用户的认证状态或属性如何，奖励链始终显示。
如为false，则仅在未找到合适的奖励链时显示。例如，当用户未认证或其属性与任何个性化奖励链都不匹配时。

仅适用于存在个性化奖励链的前提，并在未传递attribute_conditions数组时使用。

(two-letter (object or null)) or (five-letter (object or null))

包含商品详细本地化描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的区域设置代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在文档中找到支持语言的完整列表。

Any of:

两个小写字母的语言代码。

ar	string or null 阿拉伯语
bg	string or null 保加利亚语
cn	string or null 中文（简体）
cs	string or null 捷克语
de	string or null 德语
en	string or null 英语
es	string or null 西班牙语（西班牙）
fr	string or null 法语
he	string or null 希伯来语
id	string or null 印度尼西亚语
it	string or null 意大利语
ja	string or null 日语
km	string or null 高棉语
ko	string or null 韩语
lo	string or null 老挝语
my	string or null 缅甸语
ne	string or null 尼泊尔语
ph	string or null 菲律宾语
pl	string or null 波兰语
pt	string or null 葡萄牙语
ro	string or null 罗马尼亚语
ru	string or null 俄语
th	string or null 泰语
tr	string or null 土耳其语
tw	string or null 中文（繁体）
vi	string or null 越南语

order

integer

定义排列顺序。

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null))

奖励链的重置周期。

One of:

按周刷新奖励链。

interval_type required	string 奖励链定期重置的频率。 Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 用所需时区重置奖励链的时间（四舍五入到小时）。例如，奖励链重置的设定时间为吉隆坡时区(GMT+8)的01:00。在这种情况下，`time`参数的值为`01:00:00+08:00`。
day_of_week required	integer [ 1 .. 7 ] 在一周中的哪一天重置奖励链，其中“1”是星期一，“7”是星期日。

Responses

201

已成功创建奖励链。

401

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

422

无效请求。

Request samples

application/json

{"clan_type": "guild",
"date_end": "2021-04-15T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"description": {"en": "Clan reward chain description."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Clan reward chain long description."
},
"name": {"en": "Clan reward chain"
},
"order": 1,
"popup_header": {"en": "How to unlock rewards"
},
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": {"en": "You must be a clan member to get clan rewards. You join a clan when a clan member invites you to the clan, and you accept the invite. You can also create your own clan."
},
"recurrent_schedule": {"day_of_week": 1,
"interval_type": "weekly",
"time": "01:00:00+08:00"
},
"steps": [{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "First step of the reward chain"
},
"price": {"amount": 10
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_1"
},
{"quantity": 1,
"sku": "com.xsolla.item_2"
}
]
},
{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "Second step of the reward chain"
},
"price": {"amount": 15
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_3"
},
{"quantity": 1,
"sku": "com.xsolla.item_4"
}
]
}
],
"value_point": {"sku": "com.xsolla.clan_value_point_1"
}
}

Response samples

application/json

{"reward_chain_id": 10
}