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/ja/api/liveops/
https://store.xsolla.com/api/
個人用カタログ
ユーザー属性に応じたルールを指定することができるAPIです。 ユーザーが具体的なルールの条件をすべて満たした場合、パーソナライズされたアイテムが表示されます。
パーソナライズされたプロモーションについては、プロモーションセクションを参照してください。
購入前に属性を渡すには、Xsolla Login APIを使うか、Pay Station APIを使ってトークンを生成する際にそれをuser.attributesプロパティに渡します。
操作
- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- https://store.xsolla.com/api/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/44056/admin/items/value_point_3/value_points/rewards- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- https://store.xsolla.com/api/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/44056/admin/items/value_point_3/value_points/rewardsレスポンス
application/json
{ "items": [ { … }, { … } ] }
リクエスト
SKUに基づいて、1つまたは複数のアイテムのバリューポイント数を部分的に更新します。
バリューポイント更新の原則：
- アイテムがまだバリューポイントを持っていない場合、
amountフィールドにゼロ以外の値を送信すると、バリューポイントが作成されます。 - アイテムがすでにバリューポイントを持っている場合、
amountフィールドに 0 以外の値を送信すると、バリューポイントが更新されます。 amountが0に設定された場合、そのアイテムの既存のバリューポイントは削除されます。
PUTメソッド（アイテムにバリューポイントを設定する）とは異なり、このPATCHメソッドは、プロジェクト内のアイテムの既存のバリューポイントをすべて上書きするのではなく、指定されたアイテムのみを更新します。
1 つのリクエストで最大100アイテムまで更新できます。重複するアイテム SKU を同じリクエストに含めることはできません。
セキュリティ
basicAuth
一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
例: "booster_mega_1"
- Mock serverhttps://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- https://store.xsolla.com/api/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ja/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"
}
]'