SKUによる販売可能なアイテムを取得する

Note

This endpoint, accessible without authorization, returns generic data. However, authorization enriches the response with user-specific details for a personalized result, such as available user limits and promotions.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。 Example: 44056
virtual_currency_package_sku required	string 仮想通貨パッケージ SKU。 Example: crystal-pack

query Parameters

locale	string Default: "en" 応答言語。ISO 639-1に基づく小文字の2文字言語コード。
country	string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla and the process of determining the country. Example: country=US
show_inactive_time_limited_items	integer Default: 0 ユーザーに利用可能でない、期限付きアイテムを表示します。このようなアイテムの有効期間はまだ開始されていないか、すでに期限切れです。 Example: show_inactive_time_limited_items=1

Responses

200

仮想通貨パッケージは正常に受信されました。

Request samples

curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}?locale=en&country=US&show_inactive_time_limited_items=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Response samples

application/json

{"attributes": [ ],
"bundle_type": "virtual_currency_package",
"can_be_bought": true,
"content": [{"description": "Crystal - short description",
"image_url": "https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"item_id": 488831,
"limits": null,
"name": "Crystals",
"quantity": 10,
"sku": "com.xsolla.crystals_1",
"type": "virtual_currency"
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Crystal Pack Short Description",
"groups": [ ],
"image_url": "http://vc_package_image.png",
"is_free": false,
"item_id": 488832,
"limits": {"per_item": null,
"per_user": {"available": 1,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1690732800
},
"total": 1
}
},
"name": "Crystal Pack",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "100",
"amount_without_discount": "100",
"currency": "USD"
},
"promotions": [ ],
"sku": "com.xsolla.crystal_pack_1",
"type": "bundle",
"virtual_prices": [ ],
"vp_rewards": [ ]
}