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

The list of additional fields. These fields will be in the response if you send them in your request.

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

Zweistelliger Ländercode in Großbuchstaben laut ISO 3166-1 Alpha-2. Finden Sie weitere Informationen zu den von Xsolla unterstützten Ländern und dem Prozess der Bestimmung des Landes.

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": [ ]
}