# Spiel für den Katalog abrufen

Ruft ein Spiel für den Katalog ab.

HinweisAuf 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.

Endpoint: GET /v2/project/{project_id}/items/game/sku/{item_sku}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

  - `item_sku` (string, required)
    Artikel-SKU.

## Query parameters:

  - `locale` (string)
    Antwortsprache. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1.

  - `additional_fields[]` (array)
    Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, sofern Sie diese in der Anfrage senden.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

  - `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: "US"

  - `promo_code` (string)
    Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    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: 1

## Response 200 fields (application/json):

  - `attributes` (array)
    Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `attributes.external_id` (string)
    Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.
    Example: "attribute_1"

  - `attributes.name` (string)
    Name des Attributs.
    Example: "Genre"

  - `attributes.values` (array)

  - `attributes.values.external_id` (string)
    Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.
    Example: "attribute_value"

  - `attributes.values.value` (string)
    Wert des Attributs.
    Example: "Strategy"

  - `description` (string)
    Artikelbeschreibung.
    Example: "Game description"

  - `groups` (array)
    Gruppen, zu denen der Artikel gehört.
    Example: [{"external_id":"exclusive","name":"Exclusive"}]

  - `groups.external_id` (string)
    Eindeutige Kennung für die Gruppe. Dient normalerweise dazu, in API-Anfragen oder externen Systemen auf die Gruppe zu verweisen.
    Example: "exclusive"

  - `groups.item_order_in_group` (integer)
    Die Position des Artikels innerhalb der Gruppe. Dient dazu, die Anzeigereihenfolge festzulegen.
Dieses Feld ist nur dann in der Antwort enthalten, wenn es über den Abfrageparameter additional_fields[] angefordert wird.
    Example: 1

  - `groups.name` (string)
    Name der Gruppe.
    Example: "Exclusive"

  - `image_url` (string)
    Bild-URL.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `name` (string)
    Artikelname.
    Example: "Game name"

  - `promotions` (array)
    Auf bestimmte Artikel im Warenkorb angewandte Werbeaktionen. Das array wird in den folgenden Fällen zurückgegeben:

* Für einen bestimmten Artikel ist eine Rabattaktion konfiguriert.

* Ein Promocode mit der Einstellung Rabatt auf ausgewählte Artikel ist angewandt.

Werden keine Werbeaktionen auf Artikelebene angewandt, wird ein leeres Array zurückgegeben.

  - `promotions.bonus` (array)

  - `promotions.bonus.bundle_type` (string)
    Typ des im Bundle enthaltenen Bonusartikels. Nur verfügbar für Bonusartikel vom Typ bundle.
    Enum: "standard", "virtual_currency_package"

  - `promotions.bonus.image_url` (string)
    Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `promotions.bonus.name` (string)
    Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good.

  - `promotions.bonus.quantity` (integer)

  - `promotions.bonus.sku` (string)

  - `promotions.bonus.type` (string)
    Typ des Bonusartikels.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `promotions.date_end` (string,null)

  - `promotions.date_start` (string,null)

  - `promotions.discount` (object,null)

  - `promotions.discount.percent` (string,null)

  - `promotions.discount.value` (string,null)

  - `promotions.limits` (object)

  - `promotions.limits.per_user` (object)

  - `promotions.limits.per_user.available` (integer)

  - `promotions.limits.per_user.total` (integer)

  - `promotions.name` (string)

  - `sku` (string)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "game_01"

  - `type` (string)
    Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `unit_items` (array)

  - `unit_items.can_be_bought` (boolean)
    Sofern true, kann der Nutzer einen Artikel kaufen.
    Example: true

  - `unit_items.drm_name` (string)
    DRM-Name.
    Example: "Steam"

  - `unit_items.drm_sku` (string)
    Eindeutige DRM-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "steam"

  - `unit_items.has_keys` (boolean)
    Ist true eingestellt, lassen sich Spielschlüssel auf der Plattform kaufen.

  - `unit_items.is_free` (boolean)
    Ist true eingestellt, ist der Artikel kostenlos.

  - `unit_items.is_pre_order` (boolean)
    Ist true eingestellt, ist der Spielschlüssel vorbestellbar und der Release-Termin noch nicht verstrichen.
    Example: true

  - `unit_items.limits` (object,null)
    Artikelbeschränkungen.

  - `unit_items.limits.per_item` (object,null)
    Artikelbeschränkungen für einen Artikel.

  - `unit_items.limits.per_item.available` (integer)
    Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können.
    Example: 3

  - `unit_items.limits.per_item.total` (integer)
    Höchstzahl von Artikeln, die alle Nutzer kaufen können.
    Example: 5

  - `unit_items.limits.per_user` (object,null)
    Artikelbeschränkungen für einen Nutzer.

  - `unit_items.limits.per_user.available` (integer)
    Verbleibende Anzahl von Artikeln, die der aktuelle Nutzer kaufen kann.
    Example: 3

  - `unit_items.limits.per_user.limit_exceeded_visibility` (string)
    Steuert die Sichtbarkeit des Artikels im Katalog nach Erreichen des Kauflimits, und zwar bis das Limit das nächste Mal zurückgesetzt wird.

Gilt für Artikel, bei denen im Array recurrent_schedule Limits konfiguriert sind, die regelmäßig zurückgesetzt werden.

Ist keine Zurücksetzung konfiguriert, wird der Artikel nach Erreichen des Kauflimits nicht im Katalog angezeigt, unabhängig vom Wert des Parameters limit_exceeded_visibility.
    Enum: "show", "hide"

  - `unit_items.limits.per_user.recurrent_schedule` (object)
    Wiederkehrender Artikellimit-Aktualisierungszeitraums für einen Nutzer.

  - `unit_items.limits.per_user.recurrent_schedule.interval_type` (string)
    Typ des wiederkehrenden Aktualisierungszeitraums.
    Enum: "daily", "weekly", "monthly", "hourly"

  - `unit_items.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Datum und Uhrzeit, zu dem die Limits zurückgesetzt werden (Unix-Zeitstempel).
    Example: 1677553200

  - `unit_items.limits.per_user.total` (integer)
    Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann.
    Example: 5

  - `unit_items.periods` (array,null)
    Artikelangebotszeitraum.

  - `unit_items.periods.date_from` (string)
    Datum, an dem der angegebene Artikel zum Verkauf angeboten wird.
    Example: "2020-08-11T10:00:00+03:00"

  - `unit_items.periods.date_until` (string,null)
    Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: null.
    Example: "2020-08-11T20:00:00+03:00"

  - `unit_items.price` (object)
    Artikelpreise.

  - `unit_items.price.amount` (string)
    Reduzierter Artikelpreis.
    Example: "2.9900"

  - `unit_items.price.amount_without_discount` (string)
    Artikelpreis.
    Example: "2.9900"

  - `unit_items.price.currency` (string)
    Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `unit_items.release_date` (string,null)
    Release-Termin des Spielschlüssels im Format ISO 8601.
    Example: "2020-08-11T10:00:00+03:00"

  - `unit_items.type` (string)
    Artikeltyp: game_key.
    Example: "game_key"

  - `unit_items.virtual_prices` (array)
    Virtuelle Preise.

  - `unit_items.virtual_prices.amount` (integer)
    Rabattierter Artikelpreis in virtueller Währung.
    Example: 100

  - `unit_items.virtual_prices.description` (string)
    Beschreibung der virtuellen Währung.
    Example: "Big Rocket - description"

  - `unit_items.virtual_prices.image_url` (string)
    Bild der virtuellen Währung.
    Example: "http://image.png"

  - `unit_items.virtual_prices.is_default` (boolean)
    Ob der Preis für den Artikel voreingestellt ist.
    Example: true

  - `unit_items.virtual_prices.name` (string)
    Name der virtuellen Währung.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `unit_items.virtual_prices.sku` (string)
    Artikel-SKU der virtuellen Währung.
    Example: "vc_test"

  - `unit_items.virtual_prices.type` (string)
    Art der virtuellen Währung.
    Example: "virtual_currency"

  - `unit_items.vp_rewards` (array)
    Wertpunktartikel-Belohnung.

  - `unit_items.vp_rewards.amount` (integer)
    Anzahl der Wertpunkte.

  - `unit_items.vp_rewards.is_clan` (boolean)
    Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird.
    Example: true

  - `unit_items.vp_rewards.item_id` (integer)
    Interne eindeutige Artikel-ID.
    Example: 1

  - `unit_items.vp_rewards.name` (string)
    Wertpunktname.

  - `unit_items.vp_rewards.sku` (string)
    Eindeutige ID des Wertpunkts.

  - `unit_type` (string)
    Einheitstyp: game.
    Example: "game"

## Response 404 fields (application/json):

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-4001]: Item with sku = 'game_1' not found"

  - `statusCode` (integer)
    Example: 404