跳转到内容
/
获取有奖励积分的商品列表

LiveOps API (2.0.0)

Overview

  • 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 描述
index.json
index.yaml
语言
服务器
Mock server
https://xsolla.redocly.app/_mock/zh/api/liveops/
https://store.xsolla.com/api/

通用

操作

优惠券

此API让您可以管理优惠券。

操作

促销码

此API让您可以管理促销码。

操作

特别目录优惠

此API让您可以管理特别目录优惠活动。

操作

折扣

此API让您可以管理折扣促销活动。

操作

奖励

此API让您可以管理奖励促销活动。

操作

个性化目录

此API可让您针对用户属性指定规则。如果用户满足具体规则的所有条件，则会显示个性化商品。

有关个性化促销活动的信息，请参阅促销活动部分。

要在购买前传递属性，您可以使用艾克索拉Login API或在使Pay Station API生成令牌时将它们传入user.attributes属性。

操作

管理

操作

管理

操作

删除商品的奖励积分Server-sideAdmin

请求

删除所有商品的奖励积分奖励。

安全
basicAuth
路径
project_idinteger必需

项目ID。您可以在您的发布商帐户项目名称旁边找到。

示例: 44056
value_point_skustring必需

奖励积分SKU。

示例: value_point_3
curl -i -X DELETE \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/zh/api/liveops/v2/project/44056/admin/items/value_point_3/value_points/rewards

响应

已成功删除商品的奖励积分。

正文
响应
无内容

获取有奖励积分的商品列表Server-sideAdmin

请求

获取项目内有奖励积分的商品列表以用于管理。

安全
basicAuth
路径
project_idinteger必需

项目ID。您可以在您的发布商帐户项目名称旁边找到。

示例: 44056
value_point_skustring必需

奖励积分SKU。

示例: value_point_3
curl -i -X GET \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/zh/api/liveops/v2/project/44056/admin/items/value_point_3/value_points/rewards

响应

成功收到具有奖励积分的商品列表。

正文application/json
itemsArray of objects(admin-item-value-point-reward)
响应
application/json
{
  "items": [
    { … },
    { … }
  ]
}

部分更新商品的奖励积分Server-sideAdmin

请求

按照商品SKU来部分更新一个或多个商品的奖励积分数量。用户在购买指定商品后可获得这些奖励积分。

更新奖励积分的原则：

  • 如果某个商品尚无奖励积分，则在amount字段中发送非零值将创建奖励积分。
  • 如果某个商品已有奖励积分，则在amount字段中发送非零值将更新原有值。
  • 如果amount设置为0，则会删除该商品的现有奖励积分。

与PUT方法（设置商品的奖励积分）不同，此PATCH方法不会覆盖项目中所有商品的现有奖励积分，它只会更新指定的商品。

单个请求最多可以更新100个商品。同一请求中不能包含重复的商品SKU。

安全
basicAuth
路径
project_idinteger必需

项目ID。您可以在您的发布商帐户项目名称旁边找到。

示例: 44056
value_point_skustring必需

奖励积分SKU。

示例: value_point_3
正文application/jsonArray [
amountinteger>= 0必需

奖励积分的数量。

skustring(sku)[ 1 .. 255 ] characters^[a-zA-Z0-9_\-–.]*$必需

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

示例: "booster_mega_1"
]
curl -i -X PATCH \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/zh/api/liveops/v2/project/44056/admin/items/value_point_3/value_points/rewards \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "amount": 100,
      "sku": "booster_1"
    },
    {
      "amount": 0,
      "sku": "booster_mega"
    }
  ]'

响应

已成功更新商品的奖励积分。

正文
响应
无内容

客户端

操作

公会客户端

操作

管理

操作

客户端

操作

管理

操作

客户端

操作

管理

操作

客户端

操作