Xsolla-logo

SKUによる仮想通貨を取得する

get/v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}

カタログを作成するためにSKUによる仮想通貨を取得します。



このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056
virtual_currency_sku
required
string

仮想通貨SKU。

Example: crystal
query Parameters
locale
string
Default: "en"

応答言語。ISO 639-1に基づく小文字の2文字言語コード。

country
string

ISO 3166-1 alpha-2に基づく大文字の2文字国名コード。アイテム作成時に地域別の価格と制限を指定した場合、そのカタログの価格と制限を表示します。

注意

国を明示的に指定しない場合、ユーザーのIPアドレスに基づいて設定されます。

Example: country=US
show_inactive_time_limited_items
integer
Default: 0

ユーザーに利用可能でない、期限付きアイテムを表示します。このようなアイテムの有効期間はまだ開始されていないか、すでに期限切れです。

Example: show_inactive_time_limited_items=1
Responses
200

仮想通貨は正常に受信されました。

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "custom_attributes": {
    },
  • "description": "Crystals - short description",
  • "groups": [ ],
  • "inventory_options": {
    },
  • "is_free": false,
  • "item_id": 451414,
  • "limits": null,
  • "name": {
    },
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "sku": "crystal",
  • "type": "virtual_currency",
  • "virtual_prices": [ ]
}