# Warenkorb des aktuellen Benutzers abrufen

Gibt den Warenkorb des aktuellen Nutzers zurück.

Endpoint: GET /v2/project/{project_id}/cart
Version: 2.0.0
Security: AuthForCart

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `currency` (string)
    Die im Warenkorb angezeigte Währung des Artikelpreises. Dreistelliger Währungscode pro ISO 4217. Detaillierte Informationen zu Von Xsolla unterstützte Währungen.

  - `locale` (string)
    Antwortsprache. Sprachencode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1 (zum Beispiel en). Fünfstellige Gebietsschemacodes (zum Beispiel en-US) werden in Lokalisierungsfeldern wie name und description unterstützt, jedoch in den Antworten in zweistellige Codes umgewandelt. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

## Response 200 fields (application/json):

  - `cart_id` (string)
    Warenkorb-ID.
    Example: "cart_id"

  - `price` (object,null)
    Warenkorbpreis.
    Example: {"amount":"6150.0000000000000000","amount_without_discount":"6150.0000000000000000","currency":"USD"}

  - `price.amount` (string)
    Example: "6150.0000000000000000"

  - `price.amount_without_discount` (string)
    Example: "6150.0000000000000000"

  - `price.currency` (string)
    Example: "USD"

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

  - `items` (array)

  - `items.sku` (string)

  - `items.groups` (array)

  - `items.groups.external_id` (string)

  - `items.groups.name` (string)

  - `items.name` (string,null)

  - `items.attributes` (array)
    Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden.

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

  - `items.attributes.name` (string)
    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.

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

  - `items.type` (string)

  - `items.description` (string)

  - `items.image_url` (string)

  - `items.quantity` (integer)

  - `items.price` (object,null)
    Artikelpreis.
    Example: {"amount":"6150.0000000000000000","amount_without_discount":"6150.0000000000000000","currency":"USD"}

  - `items.price.amount` (string)
    Example: "6150.0000000000000000"

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

  - `items.price.currency` (string)
    Example: "USD"

  - `items.virtual_item_type` (string)
    Artikeltyp.

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

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

  - `items.virtual_prices.amount_without_discount` (integer)
    Der Artikelpreis in virtueller Währung ohne Rabatt. Immer gleich amount, da Rabatte nicht auf Preise in virtueller Währung angewendet werden.
    Example: 200

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

  - `items.virtual_prices.is_default` (boolean)
    Ob es sich um den Standardpreis in virtueller Währung handelt.
    Example: true

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

  - `items.virtual_prices.name` (string)
    Name der virtuellen Währung.
    Example: "Gold"

  - `items.virtual_prices.type` (string)
    Artikeltyp. Für die virtuelle Währung ist es virtual_currency.
    Example: "virtual_currency"

  - `items.virtual_prices.description` (string,null)
    Beschreibung der virtuellen Währung.
    Example: "In-game currency used to purchase weapons and upgrades"

  - `items.is_free` (boolean)
    Ob der Artikel kostenlos ist.

  - `items.is_bonus` (boolean)

  - `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.name` (string)

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

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

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

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

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

  - `items.promotions.bonus` (array)

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

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

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

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

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

  - `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.limits` (object)

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

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

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

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

  - `items.vp_rewards` (array)
    Liste Wertpunktbelohnungen für den Artikel.

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

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

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

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

  - `items.vp_rewards.image_url` (string)
    Bild-URL.

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

  - `items.loyalty_rewards` (array)
    Treuepunkte, die der Nutzer als Belohnung für den Kauf des Artikels erhält.

  - `items.loyalty_rewards.name` (string)
    Treuepunktname.

  - `items.loyalty_rewards.sku` (string)
    Treuepunkte-SKU. Übermittelnn Sie diesen Wert im Parameter loyalty_point_sku anderer API-Aufrufe, beispielsweise beim Anlegen einer mit Treuepunkten bezahlten Bestellung.

  - `items.loyalty_rewards.description` (string)
    Treuepunktbeschreibung.

  - `items.loyalty_rewards.image_url` (string,null)
    Bild-URL.

  - `items.loyalty_rewards.amount` (integer)
    Wie viele Treuepunkte der Nutzer für den Kauf des Artikels erhält.

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

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

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

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

  - `items.limits.per_user.recurrent_schedule` (any)

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

Wenn festgelegt ist, dass das Kauflimit nicht zurückgesetzt wird, wird der Artikel nach Erreichen des Kauflimits nicht mehr im Katalog angezeigt, unabhängig davon, welcher Wert für limit_exceeded_visibility festgelegt ist.

Mögliche Wert:
- show – Der Artikel wird in API-Aufrufen zur Katalogabfrage zurückgegeben, auch wenn das Kauflimit bereits erreicht wurde.
Bei clientseitigen API-Aufrufen zur Katalogabfrage wird der Artikel nach Erreichen des Limits mit dem Flag can_be_bought: false zurückgegeben.
Das Datum, an dem das Limit das nächste Mal zurückgesetzt wird, wird im Parameter reset_next_date zurückgegeben.
- hide – nachdem das Kauflimit erreicht wurde, wird der Artikel bei API-Aufrufen zur Katalogabfrage nicht mehr zurückgegeben, bis das Limit zurückgesetzt wird.
    Enum: "show", "hide"

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

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

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

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

  - `items.periods.date_from` (string)
    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"

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

* Eine Werbeaktion wirkt sich auf den Warenkorb-Gesamtbetrag aus, z. B. ein Promocode mit der Einstellung Rabatt auf den Kauf.

* Im Rahmen einer Werbeaktion werden Bonusartikel in den Warenkorb gelegt.

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

  - `promotions.name` (string)

  - `promotions.date_start` (string,null)

  - `promotions.date_end` (string,null)

  - `promotions.discount` (object,null)

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

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

  - `promotions.bonus` (array)

  - `promotions.bonus.sku` (string)

  - `promotions.bonus.quantity` (integer)

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

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

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

  - `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.limits` (object)

  - `promotions.limits.per_user` (object)

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

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