Virtuellen Gegenstand anhand der SKU abrufenClient-side
Ruft einen virtuellen Gegenstand anhand der SKU ab, um einen Katalog zu erstellen.
Auf diesen Endpunkt kann man ohne Autorisierung zugreifen, er gibt generische Daten zurück. Liegt eine Autorisierung vor, ist die Antwort jedoch mit benutzerspezifischen Details (z. B. vorhandene Nutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis.
path Parameters
| project_id required | integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 |
| item_sku required | string Artikel-SKU. Example: booster_mega_1 |
query Parameters
| locale | string Default: "en" Antwortsprache. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1. |
| country | string Zweistelliger Ländercode in Großbuchstaben gemäß ISO 3166-1 Alpha-2. Weitere Informationen zu den von Xsolla unterstützten Ländern und dazu, wie das Land ermittelt wird, finden Sie in der Dokumentation. Example: country=US |
| show_inactive_time_limited_items | integer Default: 0 Zeigt zeitlich begrenzte Artikel an, die nicht erhältlich sind. Der Gültigkeitszeitraum dieser Artikel hat noch nicht begonnen oder ist bereits vorüber. Example: show_inactive_time_limited_items=1 |
Der virtuelle Gegenstand wurde erfolgreich empfangen.
Der Artikel wurde nicht gefunden. Stellen Sie sicher, dass die project_id und die item_sku korrekt sind.
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
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>'
- 200
- 404
{- "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"
}
}
], - "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": [ ]
}