Xsolla-logoXsolla Developers
또는
관리자 페이지로

SKU별로 인게임 재화 가져오기Client-side

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

Gets a virtual currency by SKU for building a catalog.

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_sku
required
string

인게임 재화 SKU입니다.

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

응답 언어입니다. ISO 639-1에 따른 두 자리 소문자 언어 코드입니다.

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/sku/{virtual_currency_sku}?locale=en&country=US&show_inactive_time_limited_items=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
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": "Crystals",
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "sku": "com.xsolla.crystal_1",
  • "type": "virtual_currency",
  • "virtual_prices": [ ]
}