# Angegebenes Bundle abrufen

Ruft ein angegebenes Bundle 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/bundle/sku/{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

  - `sku` (string, required)
    Bundle-SKU.
    Example: "kg_1"

## Query parameters:

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

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

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

  - `bundle_type` (string)
    Bundle-Typ. Durch Angabe von standard erstellen Sie ein Bundle mit Artikeln, wobei die SKUs der im Bundle enthaltenen Artikel anzugeben ist.
Durch Angabe von partner_side_content wird ein leeres Bundle erstellt, wobei die Artikel über einen [Webhook](https://developers.xsolla.com/de/webhooks/operation/personalized-partner-catalog/) hinzuzufügen sind. Dieser Typ wird nur für die [Katalogpersonalisierung aufseiten des Partners](https://developers.xsolla.com/de/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side) verwendet.
    Enum: "standard", "partner_side_content"

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

  - `content` (array)
    Bundle-/Paketinhalt.
    Example: [{"attributes":[],"description":"Big Rocket - short description.","groups":[],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","is_free":false,"name":"Big Rocket","price":{"amount":"10.99","amount_without_discount":"10.99","currency":"USD"},"quantity":100,"sku":"com.xsolla.big_rocket_1","type":"virtual_currency"}]

  - `content.description` (string)
    Artikelbeschreibung.
    Example: "Big Rocket - description"

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

  - `content.groups.external_id` (string)
    Example: "horror"

  - `content.groups.name` (object)
    Name des Artikels. Sollte Schlüssel-Wert-Paare enthalten,
wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}" und der Wert ein String ist.
    Example: {"de":"Horror","en":"Horror"}

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `content.name` (string)
    Artikelname.
    Example: "Big Rocket"

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

  - `content.price.amount` (string)
    Artikelpreis mit Rabatt.
    Example: "100.99"

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

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

  - `content.quantity` (integer)
    Artikelmenge in einem Paket.
    Example: 250

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

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

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

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

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

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

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

  - `content.virtual_prices.is_default` (boolean)
    Ob es sich bei dem Preis um einen Standardpreis für einen Artikel handelt.
    Example: true

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

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

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

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

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

  - `long_description` (object,null)
    Objekt mit Lokalisierungen für lange Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Varianten angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/).

  - `media_list` (array)
    Zusätzliche Medieninhalte des Bundles.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `media_list.type` (string)
    Medieninhaltstyp: image/video.
    Enum: "image", "video"

  - `media_list.url` (string)
    Ressourcendatei.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `order` (integer)
    Priorität der Bundle-Reihenfolge in der Liste.
    Example: 1

  - `periods` (array,null)
    Artikelangebotszeitraum.

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

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

  - `price` (object,null)
    Artikelpreis.

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

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

  - `total_content_price` (object,null)
    Preissumme der einzelnen Bundle-Inhalte.

  - `total_content_price.amount` (string)
    Rabattierte Preissumme der einzelnen Bundle-Inhalte.
    Example: "100.99"

  - `total_content_price.amount_without_discount` (string)
    Preissumme der einzelnen Bundle-Inhalte.
    Example: "100.99"

  - `type` (string)
    Artikeltyp.
    Example: "bundle"

  - `vp_rewards` (array)
    Wertpunktartikel-Belohnung.

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

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

  - `vp_rewards.name` (string)
    Wertpunktname.

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