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
item_sku required	string 아이템 SKU입니다. Example: booster_mega_1

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

가상 아이템을 성공적으로 수신했습니다.

404

아이템을 찾을 수 없습니다. project_id과 item_sku가 올바른지 확인해야 합니다.

Request samples

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

Response samples

application/json

{"attributes": [{"external_id": "attr_1",
"name": {"en-US": "OK"
},
"values": [{"external_id": "val1",
"value": "VALUE"
},
{"external_id": "val2",
"value": "VALUE2"
}
]
}
],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"en": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel"
},
"groups": [{"external_id": "weapons",
"name": {"en": "weapons"
}
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 488833,
"limits": {"per_item": null,
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"name": {"en": "Sword Xsolla Skin"
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "4.99",
"amount_without_discount": "4.99",
"currency": "USD"
},
"promotions": [ ],
"sku": "com.xsolla.swords_1",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [ ],
"vp_rewards": [ ]
}