# Liste virtueller Gegenstände abrufen

Ruft eine List von virtuellen Gegenständen zum Erstellen eines Katalogs ab.

AchtungBei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erhalten können. Der Standard- und Höchstwert beträgt 50 Artikel pro Antwort. Um Seite für Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset.  HinweisDie API-Aufrufe für den Artikelkatalog können auch ohne Autorisierung verwendet werden. Um jedoch einen personalisierten Katalog abzurufen, müssen Sie den Benutzer-JWT im Authorization-Header übermitteln.

Endpoint: GET /v2/project/{project_id}/items/virtual_items
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

## Query parameters:

  - `limit` (integer)
    Begrenzung der Elementanzahl auf der Seite.
    Example: 50

  - `offset` (integer)
    Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

  - `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):

  - `has_more` (boolean)
    Dient als Indikator dafür, dass weitere Seiten vorhanden sind.
    Example: true

  - `items` (array)

  - `items.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"}]}}

  - `items.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"

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

  - `items.attributes.values` (array)

  - `items.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"

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

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

  - `items.custom_attributes` (object)
    Ein JSON-Objekt mit Artikelattributen und ‑werten.

  - `items.description` (object)
    Artikelbeschreibung.
    Example: "Big Rocket - description"

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

  - `items.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"

  - `items.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

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

  - `items.image_url` (string)
    Bild-URL.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

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

  - `items.item_id` (number)
    Artikel-ID.

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

  - `items.limits.per_item` (object,null)
    Globale Artikelbeschränkung.

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

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

  - `items.limits.per_user` (object,null)
    Artikelbeschränkung für einen separaten Nutzer.

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

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

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

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

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

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

  - `items.name` (object)
    Artikelname.
    Example: "Big Rocket"

  - `items.periods` (array)
    Artikelangebotszeitraum.

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

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

  - `items.price` (object,null)
    Artikelpreise.

  - `items.price.amount` (string)
    Reduzierter Artikelpreis.
    Example: "100.99"

  - `items.price.amount_without_discount` (string)
    Artikelpreis.
    Example: "100.99"

  - `items.price.currency` (string)
    Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu [Von Xsolla unterstützte Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items.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.

  - `items.promotions.bonus` (array)

  - `items.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"

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

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

  - `items.promotions.bonus.quantity` (integer)

  - `items.promotions.bonus.sku` (string)

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

  - `items.promotions.date_end` (string,null)

  - `items.promotions.date_start` (string,null)

  - `items.promotions.discount` (object,null)

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

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

  - `items.promotions.limits` (object)

  - `items.promotions.limits.per_user` (object)

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

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

  - `items.promotions.name` (string)

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

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

  - `items.virtual_item_type` (string)
    Art des virtuellen Gegenstands.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

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

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

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

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

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

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

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

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

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

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

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

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

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

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