コンテンツへスキップ

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記述をダウンロード
言語
サーバー
Mock server
https://xsolla.redocly.app/_mock/ja/api/liveops/
https://store.xsolla.com/api/
操作

クーポン

このAPIを使用すると、クーポンを管理できます。

操作

プロモーションコード

このAPI を使用すると、プロモーションコードを管理できます。

操作

ユニークなカタログオファー

このAPIを使用すると、ユニークなカタログオファーを管理することができます。

操作

ディスカウント

このAPIを使用すると、割引キャンペーンを管理することができます。

操作

ボーナス

このAPIを使用すると、ボーナスプロモーションを管理できます。

操作

個人用カタログ

ユーザー属性に応じたルールを指定することができるAPIです。 ユーザーが具体的なルールの条件をすべて満たした場合、パーソナライズされたアイテムが表示されます。

パーソナライズされたプロモーションについては、プロモーションセクションを参照してください。

購入前に属性を渡すには、Xsolla Login APIを使うか、Pay Station APIを使ってトークンを生成する際にそれをuser.attributesプロパティに渡します。

操作
操作

指定したユーザーのプロモーション制限を減らすServer-sideAdmin

リクエスト

指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を減らします。

User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します:

セキュリティ
basicAuth
パス
project_idinteger必須

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

例: 44056
promotion_idinteger必須

プロモーションID。プロジェクト内での一意のプロモーション識別子。

例: 111425
ボディapplication/json
availableinteger(User-limit_available)>= 1必須

適用された制限内でユーザーが利用できる残りのアイテム数またはプロモーション利用回数。

userobject(User-limit_user)必須
user.​user_external_idstring(User-limit_user-external-id)non-empty^\S+$必須

ユーザーexternal ID。

curl -i -X DELETE \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/44056/admin/user/limit/promotion/id/111425 \
  -H 'Content-Type: application/json' \
  -d '{
    "available": 1,
    "user": {
      "user_external_id": "d342dad2-9d59-11e9-a384-42010aa8003f"
    }
  }'

レスポンス

ユーザーのプロモーション制限が正常に受信されました。

ボディapplication/json
per_userobject
レスポンス
application/json
{ "per_user": { "available": 9, "total": 10 } }

指定したユーザーのプロモーション制限を取得するServer-sideAdmin

リクエスト

指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を取得します。

User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します:

セキュリティ
basicAuth
パス
project_idinteger必須

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

例: 44056
promotion_idinteger必須

プロモーションID。プロジェクト内での一意のプロモーション識別子。

例: 111425
クエリ
user_external_idstring必須

ユーザーexternal ID

例: user_external_id=d342dad2-9d59-11e9-a384-42010aa8003f
curl -i -X GET \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/44056/admin/user/limit/promotion/id/111425?user_external_id=d342dad2-9d59-11e9-a384-42010aa8003f'

レスポンス

ユーザーのプロモーション制限が正常に受信されました。

ボディapplication/json
per_userobject
レスポンス
application/json
{ "per_user": { "available": 9, "total": 10 } }

指定したユーザーのプロモーション制限を増やすServer-sideAdmin

リクエスト

指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を増やします。

User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します:

セキュリティ
basicAuth
パス
project_idinteger必須

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

例: 44056
promotion_idinteger必須

プロモーションID。プロジェクト内での一意のプロモーション識別子。

例: 111425
ボディapplication/json
availableinteger(User-limit_available)>= 1必須

適用された制限内でユーザーが利用できる残りのアイテム数またはプロモーション利用回数。

userobject(User-limit_user)必須
user.​user_external_idstring(User-limit_user-external-id)non-empty^\S+$必須

ユーザーexternal ID。

curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ja/api/liveops/v2/project/44056/admin/user/limit/promotion/id/111425 \
  -H 'Content-Type: application/json' \
  -d '{
    "available": 1,
    "user": {
      "user_external_id": "d342dad2-9d59-11e9-a384-42010aa8003f"
    }
  }'

レスポンス

ユーザーのプロモーション制限が正常に受信されました。

ボディapplication/json
per_userobject
レスポンス
application/json
{ "per_user": { "available": 9, "total": 10 } }
操作

クライアント

操作

クランクライアント

操作
操作

クライアント

操作
操作

クライアント

操作
操作

クライアント

操作