Spielschlüssel für den Katalog abrufenClient-side
Gets a game key for the catalog.
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.
path Parameters
| project_id required | integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 |
| item_sku required | string Default: "xsollus_basic_edition_steam" Artikel-SKU. |
query Parameters
| locale | string Default: "en" Antwortsprache. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1. |
| additional_fields[] | Array of strings Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, sofern Sie diese in der Anfrage senden. |
| 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 |
| promo_code | string [ 1 .. 128 ] characters Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: promo_code=WINTER2021 |
| 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 |
Spielschlüssel wurde erfolgreich empfangen.
Spielschlüssel nicht gefunden.
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
curl -i -X GET \ 'https://store.xsolla.com/api/v2/project/{project_id}/items/game/key/sku/{item_sku}?locale=en&additional_fields%5B%5D=media_list&country=US&promo_code=WINTER2021&show_inactive_time_limited_items=1' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
- 200
- 404
{- "attributes": [
- {
- "external_id": "OS",
- "name": "OS",
- "values": [
- {
- "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
- "value": "Windows"
}
]
}, - {
- "external_id": "genre",
- "name": "Genre",
- "values": [
- {
- "external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
- "value": "Horror"
}
]
}
], - "can_be_bought": true,
- "description": "Game description",
- "drm_name": "Steam",
- "drm_sku": "steam_key_1",
- "groups": [
- {
- "external_id": "all",
- "name": "All games"
}, - {
- "external_id": "Xsolla",
- "name": "Xsolla games"
}
], - "has_keys": true,
- "is_free": false,
- "is_pre_order": true,
- "limits": null,
- "name": "Game name",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "30.5",
- "amount_without_discount": "30.5",
- "currency": "USD"
}, - "promotions": [ ],
- "release_date": "2020-08-11T10:00:00+03:00",
- "sku": "com.xsolla.game_1",
- "type": "game_key",
- "virtual_prices": [ ]
}