LiveOps API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
LiveOps API提供用于提升玩家参与度的端点。
下载 OpenAPI 描述
语言
服务器
Mock server
https://xsolla.redocly.app/_mock/zh/api/liveops/
https://store.xsolla.com/api/
正文application/json
attribute_conditionsArray of type = string (object) or type = number (object) or type = date (object)(promotion_user-attribute_conditions_model-post)[ 1 .. 100 ] items
用户属性验证条件。 根据用户属性是否满足所有指定条件来确定促销活动可用性。
要应用促销必须在购买项中包含的一组商品。如果此参数为null，则促销将应用于项目内的任何购买。
应用此促销活动时要排除的促销活动ID列表。
Example：[12, 789]
示例: [12,789]
促销活动名称。应包含键/值对，其中键是"^[a-z]{2}-[A-Z]{2}$"格式的区域设置，值是字符串。
示例: {"de-DE":"Sommersaison Bonus","en-US":"Summer season bonus"}
包含条件的对象数组，用于设置应用促销活动的价格范围。
促销活动仅应用于价格符合数组中所有条件的商品。如果传递此数组，请将condition对象的值设置为null。
- Mock serverhttps://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/{project_id}/admin/promotion/bonus
- https://store.xsolla.com/api/v3/project/{project_id}/admin/promotion/bonus
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/44056/admin/promotion/bonus \
-H 'Content-Type: application/json' \
-d '{
"attribute_conditions": [
{
"attribute": "account_status",
"can_be_missing": false,
"operator": "eq",
"type": "string",
"value": "golden"
}
],
"bonus": [
{
"quantity": 50000,
"sku": "com.xsolla.mp_credits"
}
],
"condition": [
{
"sku": "com.xsolla.year_1_season_pass"
}
],
"name": {
"de-DE": "Neujahrsbonus",
"en-US": "New Year Bonus"
},
"promotion_periods": [
{
"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
]
}'响应
application/json
{ "promotion_id": 2384756 }
- Mock serverhttps://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/{project_id}/admin/promotion/{promotion_id}/bonus
- https://store.xsolla.com/api/v3/project/{project_id}/admin/promotion/{promotion_id}/bonus
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/44056/admin/promotion/111425/bonus- Mock serverhttps://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/{project_id}/admin/promotion/{promotion_id}/bonus
- https://store.xsolla.com/api/v3/project/{project_id}/admin/promotion/{promotion_id}/bonus
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/zh/api/liveops/v3/project/44056/admin/promotion/111425/bonus奖励促销活动已成功收到。
attribute_conditionsArray of type = string (object) or type = number (object) or type = date (object)(promotion_user-attribute_conditions_model-get)[ 1 .. 100 ] items
用户属性验证条件。 根据用户属性是否满足所有指定条件来确定促销活动可用性。
应用此促销活动时要排除的促销活动ID列表。
Example：[12, 789]
示例: [12,789]
促销活动名称。应包含键/值对， 其中键是"^[a-z]{2}-[A-Z]{2}$"格式的区域设置，值是字符串。
示例: {"de-DE":"Sommersaison Bonus","en-US":"Summer season bonus"}
包含条件的对象数组，用于设置应用促销活动的价格范围。
促销活动仅应用于价格符合数组中所有条件的商品。如果传递此数组，请将condition对象的值设置为null。
响应
application/json
{ "bonus": [ { … }, { … }, { … } ], "condition": [ { … }, { … } ], "excluded_promotions": [ 23, 45 ], "id": 1, "is_enabled": true, "limits": { "per_item": null, "per_user": { … }, "recurrent_schedule": { … } }, "name": { "de-DE": "Neujahrsbonus", "en-US": "New Year Bonus" }, "price_conditions": [ { … }, { … } ], "promotion_periods": [ { … } ] }
个性化目录
此API可让您针对用户属性指定规则。如果用户满足具体规则的所有条件，则会显示个性化商品。
有关个性化促销活动的信息，请参阅促销活动部分。
要在购买前传递属性，您可以使用艾克索拉Login API或在使Pay Station API生成令牌时将它们传入user.attributes属性。
操作