Xsolla-logo

Spielschlüssel für den Katalog abrufenClient-side

get/v2/project/{project_id}/items/game/key/sku/{item_sku}

Ruft einen Spielschlüssel für den Katalog ab.

Hinweis

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 Benutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis.
SecurityXsollaLoginUserJWT
Request
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, wenn Sie sie in Ihrer Anfrage senden.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

Ländercode bestehend aus zwei Großbuchstaben gemäß ISO 3166-1 ALPHA-2. Zeigt regionale Preise und Beschränkungen für einen Katalog an, sofern diese beim Erstellen eines Artikels angegeben wurden.

Hinweis

Wenn Sie das Land nicht explizit angeben, wird es basierend auf der IP-Adresse des Benutzers festgelegt.

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
Responses
200

Spielschlüssel wurde erfolgreich empfangen.

404

Spielschlüssel nicht gefunden.

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "description": "Game description",
  • "drm_name": "Steam",
  • "drm_sku": "steam",
  • "groups": [
    ],
  • "has_keys": true,
  • "is_free": false,
  • "is_pre_order": true,
  • "limits": null,
  • "name": "Game name",
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "release_date": "2020-08-11T10:00:00+03:00",
  • "sku": "game_1",
  • "type": "game_key",
  • "virtual_prices": [ ]
}