# Katalog-API # Überblick {% #overview %} - **Version:** 2.0.0 - **Server:** `https://store.xsolla.com/api` - [Kontakt-E-Mail-Adresse](mailto:integration@xsolla.com) - **Kontakt-URL:** https://xsolla.com/ - **Erforderliche TLS-Version:** 1.2 Mit der Katalog-API können Sie aufseiten von Xsolla einen Katalog mit Ingame-Items konfigurieren und diesen Katalog den Nutzern in Ihrem Shop anzeigen. Über die API können Sie die folgenden Katalogentitäten verwalten: * **Virtuelle Gegenstände** – Ingame-Items wie etwa Waffen, Skins, Booster. * **Virtuelle Währung** – Virtuelles Geld für den Kauf von virtuellen Gütern. * **Virtuelle Währungspakete** – vordefinierte Pakete voller virtueller Währung. * **Bundles** – eine Kombination aus virtuellen Gegenständen, Währung oder Spielschlüsseln. Bundles werden als eine einzelne SKU verkauft. * **Spielschlüssel** – Schlüssel für Spiele oder DLCs, die über Plattformen wie Steam oder andere DRM-Anbieter vertrieben werden. * **Gruppen** – logische Gruppierungen, um Artikel im Katalog zu organisieren und zu sortieren. ## API-Aufrufe {% #api-calls %} Die API ist in die folgenden Gruppen unterteilt: * **Admin** – Aufrufe zum Erstellen, Aktualisieren, Löschen und Konfigurieren von Katalogartikeln und ‑gruppen. Die Authentifizierung erfolgt über die [Basisauthentifizierung](https://developers.xsolla.com/de/payment-ui-and-flow/payment-ui/how-to-get-payment-token/#payments_solution_get_user_auth_token_basic_auth) und Ihre Händler- oder Projekt-Anmeldedaten. Diese Aufrufe sind nicht für den Storefront bestimmt. * **Catalog** – Aufrufe zum Abrufen von Artikeln und zum Erstellen benutzerdefinierter Storefronts für Endnutzer. Konzipiert für den Einsatz unter hoher Auslastung. Unterstützt die optionale Nutzer-JWT-Autorisierung und kann personalisierte Daten (z. B. benutzerspezifische Limits und aktive Werbeaktionen) zurückgeben. # Authentifizierung {% #authentication %} API-Aufrufe erfordern eine Authentifizierung entweder im Namen eines Nutzers oder im Namen eines Projekts. Das verwendete Authentifizierungsschema ist im Abschnitt **Sicherheit** – in der Beschreibung des jeweiligen Aufrufs – angegeben. ## Authentifizierung mit Benutzer-JWT {% #authentication-using-users-jwt %} Die Authentifizierung mit Benutzer-JWT kommt zum Einsatz, wenn eine Anfrage von einem Browser, einer App oder einem Spiel gesendet wird. Standardmäßig wird das Schema `XsollaLoginUserJWT` angewendet. Weitere Informationen zum Erstellen eines Tokens finden Sie in der [Dokumentation zur Xsolla-Login-API](/de/api/login/authentication-schemes#getting-user-token). Der Token wird im `Authorization`-Header im folgenden Format übermittelt: `Authorization: Bearer `, wobei `` der Benutzertoken ist. Der Token dient dazu, den Nutzer zu identifizieren und ihm Zugriff auf personalisierte Daten zu ermöglichen. Alternativ können Sie einen [Token zum Öffnen des Zahlungsportals verwenden](/de/api/pay-station/token/create-token). ## HTTP-Basisauthentifizierung {% #basic-http-authentication %} Die HTTP-Basisauthentifizierung wird für Server-zu-Server-Interaktionen verwendet, wenn ein API-Aufruf direkt von Ihrem Server und nicht von einem Browser oder einer App gesendet wird. Typischerweise wird die HTTP-Basisauthentifizierung gemeinsam mit einem [API-Schlüssel](/de/api/getting-started/#api_keys_overview) verwendet.
Hinweis

Der API-Schlüssel ist vertraulich und darf nicht in Client-Anwendungen gespeichert oder verwendet werden.
Bei der serverseitigen Basisauthentifizierung müssen alle API-Anfragen den folgenden Header enthalten: - für `basicAuth` – `Authorization: Basic `, wobei `your_authorization_basic_key` das gemäß Base64-Verfahren kodierte `project_id:api_key`-Paar ist - für `basicMerchantAuth` – `Authorization: Basic `, wobei `your_authorization_basic_key` das gemäß Base64-Verfahren kodierte `merchant_id:api_key` Paar ist Die Parameterwerte finden Sie im [Kundenportal](https://publisher.xsolla.com/) an folgenden Orten: - `merchant_id` wird angezeigt: - unter **Firmeneinstellungen > Firma**. - in der URL in der Adressleiste des Browsers auf einer beliebigen Seite im Kundenportal. Die URL hat das folgende Format: `https://publisher.xsolla.com/`. - `project_id` wird angezeigt: - neben dem Projektnamen im Kundenportal. - in der URL 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/`. - `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel in Ihrem System zu speichern. Einen API-Schlüssel können Sie an den folgenden Orten erstellen: - unter [Firmeneinstellungen > API-Schlüssel](https://publisher.xsolla.com/0/settings/api_key) - unter [Projekteinstellungen > API-Schlüssel](https://publisher.xsolla.com/0/projects/0/edit/api_key)
Hinweis

Falls bei einem erforderlichen API-Aufruf der Pfadparameter project_id fehlt, müssen Sie einen API-Schlüssel verwenden, der für alle Projekte der Firma gültig ist.
Weitere Informationen zur Arbeit mit API-Schlüsseln finden Sie in den [API-Referenzen](/de/api/getting-started/#api_keys_overview). ## Authentifizierung mit Unterstützung für Gastzugang {% #authentication-with-guest-access-support %} Das Authentifizierungsschema `AuthForCart` wird für Warenkorbkäufe verwendet und unterstützt zwei Modi: 1. **Authentifizierung mit einem Benutzer-JWT.** Der Token wird im `Authorization`-Header im folgenden Format übermittelt: `Authorization: Bearer `, wobei `` der Benutzertoken ist. Der Token dient dazu, den Nutzer zu identifizieren und ihm Zugriff auf personalisierte Daten zu ermöglichen. Alternativ können Sie einen [Token zum Öffnen des Zahlungsportals](/de/api/pay-station/token/create-token) verwenden. 2. **Vereinfachter Modus ohne Autorisierungs-Header.** Dieser Modus ist nur für nicht autorisierte Nutzer vorgesehen und kann lediglich für den [Verkauf von Spielschlüsseln](/de/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users) genutzt werden. Anstelle eines Tokens muss die Anfrage die folgenden Header enthalten: - `x-unauthorized-id` samt Anfrage-ID - `x-user` samt der E-Mail-Adresse des Nutzers, kodiert in Base64 ## Nützliche Links {% #authentication-useful-links %} - [API-Aufrufe nach Interaktionsmodell](/de/api/getting-started/#api_interaction_model) - [Endpunkttypen](/de/api/getting-started/#api_endpoint_types) - [Fehlerbehandlung](/de/api/getting-started/#api_errors_handling) - [API-Schlüssel](/de/api/getting-started/#api_keys_overview) - [Webhooks](/de/webhooks/overview) # Grundstruktur der Entität {% #core-entity-structure %} Alle Artikeltypen (virtuelle Gegenstände, Bundles, virtuelle Währung und Schlüssel) haben eine ähnliche Datenstruktur. Kenntnisse über die Grundstruktur vereinfachen die Arbeit mit der API und erleichtern das Navigieren in der Dokumentation.
Hinweis

Einige Aufrufe können zusätzliche Felder enthalten, doch diese ändern nichts an der Grundstruktur.
**Identifikation** - `merchant_id` – Firmen-ID im [Kundenportal](https://publisher.xsolla.com/) - `project_id` – Projekt-ID im Kundenportal - `sku` – Artikel-SKU, einzigartig innerhalb des Projekts **Shop-Anzeige** - `name` – Artikelname - `description` – Artikelbeschreibung - `image_url` – Bild-URL - `is_enabled` – Artikelverfügbarkeit - `is_show_in_store` – ob der Artikel im Katalog angezeigt wird Weitere Informationen zur Verwaltung der Artikelverfügbarkeit im Katalog finden Sie in der [Dokumentation](/de/items-catalog/catalog-features/items-availability/). **Organisation** - `type` – Artikeltyp, zum Beispiel ein virtueller Gegenstand (`virtual_item`) oder Bundle (`bundle`) - `groups` – Gruppen, zu denen der Artikel gehört - `order` – Anzeigereihenfolge im Katalog **Verkaufsbedingungen** - `prices` – Preise in echter oder virtueller Währung - `limits` – Kauflimits - `periods` – Verfügbarkeitszeiträume - `regions` – regionale Beschränkungen **Grundstruktur einer Entität (Beispiel):** ```json { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": { "en": "Main in-game currency" }, "image_url": "https://.../image.png", "name": { "en": "Crystals", "de": "Kristalle" }, "quantity": 500, "sku": "com.xsolla.crystal_2", "type": "virtual_currency" } ], "description": { "en": "Crystals x500" }, "groups": [], "image_url": "https://.../image.png", "is_enabled": true, "is_free": false, "is_show_in_store": true, "limits": { "per_item": null, "per_user": null, "recurrent_schedule": null }, "long_description": null, "media_list": [], "name": { "en": "Medium crystal pack" }, "order": 1, "periods": [ { "date_from": null, "date_until": "2020-08-11T20:00:00+03:00" } ], "prices": [ { "amount": 20, "country_iso": "US", "currency": "USD", "is_default": true, "is_enabled": true } ], "regions": [], "sku": "com.xsolla.crystal_pack_2", "type": "bundle", "vc_prices": [] } ``` # Grundlegender Kaufablauf {% #basic-purchase-flow %} Über die Xsolla-API lässt sich die Logik für einen Ingame-Shop implementieren, darunter das Abrufen des Artikelkatalogs, die Verwaltung des Warenkorbs, das Anlegen von Bestellungen und die Verfolgung des Bestellstatus. Je nach Integrationsszenario sind die API-Aufrufe in die Unterbereiche **Verwaltung** und **Katalog** unterteilt, die unterschiedliche [Authentifizierungsschemen](/de/api/catalog/authentication) verwenden. Das folgende Beispiel zeigt den grundlegenden Ablauf für die Einrichtung und den Betrieb eines Shops, von der Artikelerstellung bis zum Kauf. ## Artikel und Gruppen erstellen (Verwaltung) {% #create-items-and-groups-admin %} Erstellen Sie für Ihren Shop einen Katalog mit Artikeln wie etwa virtuellen Gegenständen, Bundles oder virtueller Währung. API-Aufrufe (Beispiele): - [Virtuellen Gegenstand erstellen](/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-item) - [Bundle erstellen](/de/api/catalog/bundles-admin/admin-create-bundle) - [Virtuelle Währung erstellen](/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency) ## Werbeaktionen, Ketten und Limits einrichten (Verwaltung) {% #set-up-promotions-chains-and-limits-admin %} Konfigurieren Sie Tools für die Nutzergewinnung und Monetarisierung, wie etwa Rabatte, Boni, tägliche Belohnungen oder Angebotsketten. API-Aufrufe (Beispiele): - [Bonusaktion erstellen](/de/api/liveops/promotions-bonuses/create-bonus-promotion) - [Tägliche Belohnung erstellen](/de/api/liveops/daily-chain-admin/admin-create-daily-chain) - [Katalogsonderangebot erstellen](/de/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer) ## Artikelinformationen abrufen (Client) {% #get-item-information-client %} Konfigurieren Sie, wie Artikel in Ihrer Anwendung angezeigt werden sollen.
Hinweis

Verwenden Sie keine API-Aufrufe aus dem Unterabschnitt "Verwaltung", um einen Nutzerkatalog zu erstellen. Diese API-Aufrufe unterliegen Ratenbegrenzungen und sind nicht für Nutzer-Traffic vorgesehen.

API-Aufrufe (Beispiele): - [Liste virtueller Gegenstände abrufen](/de/api/catalog/virtual-items-currency-catalog/get-virtual-items) - [Liste der Artikelgruppen abrufen](/de/api/catalog/virtual-items-currency-catalog/get-item-groups) - [Liste der Bundles abrufen](/de/api/catalog/bundles-catalog/get-bundle-list) - [Liste der verkäuflichen Artikel abrufen](/de/api/catalog/common-catalog/get-sellable-items)
Hinweis

Standardmäßig geben katalogbezogene API-Aufrufe Artikel zurück, die zum Zeitpunkt der Anfrage im Shop verfügbar sind. Um Artikel abzurufen, die noch nicht verfügbar oder nicht mehr verfügbar sind, müssen Sie den Parameter "show_inactive_time_limited_items": 1 in der Kataloganfrage ergänzen.
## Artikel verkaufen {% #sell-items %} Artikel können Sie mit den folgenden Methoden verkaufen: - Schnellkauf – Verkauf einer einzelnen SKU in beliebiger Menge. - Warenkorbkauf – der Nutzer kann im Rahmen einer Bestellung Artikel in den Warenkorb legen, Artikel aus dem Warenkorb entfernen und die Menge jedes einzelnen Artikels ändern. Wird ein Artikel mit virtueller Währung anstelle von echtem Geld gekauft, müssen Sie den API-Aufruf [Bestellung mit einem angegebenen, in virtueller Währung gekauften Artikel anlegen](/de/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency) verwenden. Das Zahlungsportal muss nicht aufgerufen werden, da die Zahlungsabwicklung bei Ausführung des API-Aufrufs erfolgt. Beim Kauf eines kostenlosen Artikels müssen Sie den API-Aufruf [Bestellung mit angegebenem kostenlosen Artikel anlegen](/de/api/catalog/free-item/create-free-order-with-item) oder den API-Aufruf [Bestellung mit einem kostenlosen Warenkorb anlegen](/de/api/catalog/free-item/create-free-order) verwenden. as Zahlungsportal muss nicht aufgerufen werden – der Bestellung wird sofort der Status done zugewiesen. ### Schnellkauf {% #fast-purchase %} Verwenden Sie den clientseitigen API-Aufruf, um [eine Bestellung mit einem angegebenen Artikel anzulegen](/de/api/catalog/payment-client-side/create-order-with-item). Der Aufruf gibt einen Token zurück, mit dem sich das Zahlungsportal öffnen lässt.
Hinweis

Rabattinformationen sind für den Nutzer nur im Zahlungsportal verfügbar. Promocodes werden nicht unterstützt.
### Warenkorbkauf {% #cart-purchase %} Die Einrichtung des Warenkorbs und der Kaufvorgang können sowohl client- als auch serverseitg erfolgen. **Warenkorb clientseitig einrichten und Artikel kaufen** Implementieren Sie die Logik für das Hinzufügen und Entfernen von Artikeln selbst. Bevor Sie die API zum Einrichten eines Warenkorbs aufrufen, liegen Ihnen keine Informationen darüber vor, welche Werbeaktionen auf den Kauf angewendet werden. Die Gesamtkosten und die Details der hinzugefügten Bonusartikel sind Ihnen also unbekannt. Implementieren Sie die folgende Warenkorblogik: 1. Verwenden Sie den API-Aufruf [Artikel in den Warenkorb legen](/de/api/shop-builder/operation/cart-fill/), nachdem der Spieler einen Warenkorb zusammengestellt hat. Der Aufruf gibt die aktuellen Informationen zu den ausgewählten Artikeln zurück (Preise mit und ohne Rabatt, Bonusartikel). 2. Aktualisieren Sie den Warenkorbinhalt basierend auf den Aktionen des Nutzers: - Verwenden Sie den API-Aufruf [Warenkorbartikel anhand von Warenkorb-ID aktualisieren](/de/api/shop-builder/operation/put-item-by-cart-id/), um einen Artikel in den Warenkorb zu legen oder die Artikelmenge zu ändern. - Verwenden Sie den API-Aufruf [Warenkorbartikel anhand von Warenkorb-ID löschen](/de/api/shop-builder/operation/delete-item-by-cart-id/), um einen Artikel zu entfernen.
Hinweis

Mit dem API-Aufruf "Warenkorb des aktuellen Benutzers abrufen" können Sie den aktuellen Status des Warenkorbs abrufen.
3. Verwenden Sie den API-Aufruf [Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen](/de/api/shop-builder/operation/create-order/). Der Aufruf gibt die Bestell-ID und den Zahlungstoken zurück. Der neu angelegten Bestellung wird standardmäßig der Status new zugewiesen. **Warenkorb serverseitig einrichten und Artikel kaufen** Diese Einrichtungsoption kann länger dauern, da jede Änderung am Warenkorb durch API-Aufrufe vorgenommen werden muss. Implementieren Sie die folgende Warenkorblogik: 1. Verwenden Sie den API-Aufruf [Artikel in den Warenkorb legen](/de/api/catalog/cart-server-side), nachdem der Spieler einen Warenkorb zusammengestellt hat. Der Aufruf gibt die aktuellen Informationen zu den ausgewählten Artikeln zurück (Preise mit und ohne Rabatt, Bonusartikel). 2. Verwenden Sie den API-Aufruf [Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen](/de/api/shop-builder/operation/create-order/). Der Aufruf gibt die Bestell-ID und den Zahlungstoken zurück. Der neu angelegten Bestellung wird standardmäßig der Status new zugewiesen. ## Zahlungsportal öffnen {% #open-payment-ui %} Verwenden Sie den zurückgegebenen Token, um das Zahlungsportal in einem neuen Fenster zu öffnen. Weitere Möglichkeiten, das Zahlungsportal zu öffnen, sind in der [Dokumentation](/de/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui) beschrieben. | Aktion | Endpunkt | |:--------------------------------|:--------------------------------------------------------------------------| | In der Produktionsumgebung öffnen. | https://secure.xsolla.com/paystation4/?token={token} | | In der Testumgebung öffnen. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |
Hinweis

Nutzen Sie die Testumgebung während der Entwicklung und zum Testen. Es stehenn Test-Bankkarten bereit. Bei Testkäufen wird kein Geld von echten Konten abgebucht. Sobald die erste tatsächliche Zahlung erfolgt ist, tritt eine strenge Zahlungsrichtlinie für die Testumgebung in Kraft: Ab dann dürfen nur noch die unter [Kundenportal > Firmeneinstellungen > Nutzer](https://publisher.xsolla.com/0/settings/users) angegebenen Nutzer ein Zahlung in der Testumgebung tätigen . Der Kauf von virtueller Währung und Gegenständen gegen echtes Geld ist erst nach Unterzeichnung einer Lizenzvereinbarung möglich. Navigieren Sie dazu im [Kundenportal](https://publisher.xsolla.com/) zu **Vereinbarungen und Steuern > Vereinbarungen**, füllen Sie das Formular aus, und warten Sie auf die Bestätigung. Die Prüfung kann bis zu drei Werktage dauern.
Die Testumgebung können Sie aktivieren oder deaktivieren. Ändern Sie dazu einfach den Wert des Parameters `sandbox` in der Schnellkauf- bzw. Warenkorbkauf-Anfrage. Die Testumgebung ist standardmäßig deaktiviert. Mögliche Bestellstatus: - `new` – Bestellung angelegt - `paid` – Zahlung erhalten - `done` – Artikel geliefert - `canceled` – Bestellung storniert - `expired` – Bestellung abgelaufen Tracken Sie den Bestellstatus mit einer der folgenden Methoden: - [mit auf Ihrem Server konfigurierten Webhooks](/de/virtual-goods/own-ui/server-side-token-generation/set-up-order-tracking/#payments_integration_order_tracking) - [per Short-polling](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_short_polling) - [per WebSocket API](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_websocket_api) ## Nützliche Links {% #basic-purchase-flow-useful-links %} - Authentifizierung - [API-Aufrufe nach Interaktionsmodell](/de/api/catalog/authentication) - [Zahlungstests](/de/dev-resources/testing/general-info/#general_overview) - [Bestellstatus-Tracking einrichten](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?link=200-api#payments_integration_order_tracking) - [Webhooks](/de/webhooks/overview) - [Ratenlimits](/de/api/login/rate-limits) - [Fehlerbehandlung](/de/api/getting-started/#api_errors_handling) - [API-Schlüssel](/de/api/getting-started/#api_keys_overview) # Paginierung {% #pagination %} API-Aufrufe, die umfangreiche Datensätze zurückgeben (beispielsweise beim Erstellen eines Katalogs), liefern Daten seitenweise. Die Paginierung ist ein Mechanismus, der die Anzahl der in einer einzelnen API-Antwort zurückgegebenen Elemente begrenzt und es ermöglicht, aufeinanderfolgende Seiten der Reihe nach abzurufen. Mithilfe der folgenden Parameter können Sie die Anzahl der zurückgegebenen Elemente steuern: - `limit` – Anzahl der Elemente pro Seite - `offset` – Index des ersten Elements auf der Seite (Nummerierung beginnt bei 0) - `has_more` – gibt an, ob eine weitere Seite verfügbar ist - `total_items_count` – Gesamtanzahl der Elemente Beispielanfrage: ``` GET /items?limit=20&offset=40 ``` Beispielantwort: ```json { "items": [...], "has_more": true, "total_items_count": 135 } ``` Es wird empfohlen, nachfolgende Anfragen zu senden, bis die Antwort `has_more = false` zurückgibt. # Datums- und Zeitformat {% #date-and-time-format %} Datums- und Zeitwerte werden im [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)-Format übermittelt. Folgende Formate werden unterstützt: - UTC-Offset - `null`-Wert, wenn keine zeitliche Einschränkung für die Anzeige eines Artikels besteht - [Unix-Zeitstempel](https://www.unixtimestamp.com/) (in Sekunden), der in einigen Feldern verwendet wird Format: `YYYY-MM-DDTHH:MM:SS±HH:MM` Beispiel: `2026-03-16T10:00:00+03:00` # Lokalisierung {% #localization %} Xsolla unterstützt die Lokalisierung von benutzerseitigen Feldern wie Artikelname und Beschreibung. Lokalisierte Werte werden als Objekt übermittelt, wobei der Sprachcode als Schlüssel verwendet wird. Die vollständige Liste der unterstützten Sprachen ist in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/) verfügbar. **Unterstützte Felder** Für die folgenden Parameter kann eine Lokalisierung festgelegt werden: - `name` - `description` - `long_description` **Gebietsschemaformat** Der Gebietsschemaschlüssel kann in einem der folgenden Formate angegeben werden: - Sprachencode bestehend aus zwei Buchstaben: `en`, `ru` - Sprachencode bestehend aus fünf Buchstaben: `en-US`, `ru-RU`, `de-DE` **Beispiele** Zweistelliger Sprachencode (Beispiel): ```json { "name": { "en": "Starter Pack", "ru": "Стартовый набор" } } ``` Fünfstelliger Sprachencode (Beispiel): ```json { "description": { "en-US": "Premium bundle", "de-DE": "Premium-Paket" } } ``` # Land und Währung ermitteln {% #country-and-currency-determination %} Das Land des Nutzers bestimmt die Katalogpreise, die Zahlungswährung und die verfügbaren Zahlungsmethoden im Zahlungsportal. Je nach API-Aufruf wird das Land wie folgt ermittelt:
  • Bei clientseitigen API-Aufrufen wird das Land anhand der IP-Adresse, von der die Anfrage stammt, ermittelt.
  • Bei serverseitigen API-Aufrufen wird das Land anhand des Werts des Parameters user.country.value oder anhand der IP-Adresse des Nutzers aus dem X-User-Ip-Header ermittelt. Werden beide Werte übermittelt, hat der Parameter user.country.value Vorrang.
Hinweis

Länder können nur anhand von IPv4-Adressen ermittelt werden. Wird eine IPv6-Adresse übermittelt, kann es zu einer fehlerhaften Länder- und Währungserkennung kommen. Wenn Sie den serverseitigen API-Aufruf verwenden und die IPv4-Adresse des Nutzers nicht angeben können, können Sie das Land auch im Parameter user.country.value übermitteln.
# Fehlerantwortformat {% #error-response-format %} Wenn ein Fehler auftritt, gibt die API einen HTTP-Statuscode und einen JSON-Antwortrumpf zurück. Die vollständige Liste der shopbezogenen Fehler ist in der [Dokumentation](/de/dev-resources/references/errors/store-errors/) verfügbar. **Antwort (Beispiel):** ```json { "errorCode": 1102, "errorMessage": "Validation error", "statusCode": 422, "transactionId": "c9e1a..." } ``` - `errorCode` – Fehlercode. - `errorMessage` – kurze Fehlerbeschreibung. - `statusCode` – HTTP-Antwortstatus. - `transactionId` – Anfrage-ID. Wird nur in einigen Fällen zurückgegeben. - `errorMessageExtended` – zusätzliche Fehlerdetails, wie z. B. Anfrageparameter. Wird nur in einigen Fällen zurückgegeben. **Erweiterte Antwort (Beispiel):** ```json { "errorCode": 7001, "errorMessage": "Chain not found", "errorMessageExtended": { "chain_id": "test_chain_id", "project_id": "test_project_id", "step_number": 2 }, "statusCode": 404 } ``` **Gängige HTTP-Statuscodes** - `400` – ungültige Anfrage - `401` – Authentifizierungsfehler - `403` – mangelnde Berechtigungen - `404` – Ressource nicht gefunden - `422` – Validierungsfehler - `429` – Ratenlimit überschritten **Empfehlungen** - Verarbeiten Sie den HTTP-Statuscode und den Antwortrumpf gemeinsam. - Verwenden Sie `errorCode`, um Fehler im Zusammenhang mit der Anwendungslogik zu verarbeiten. - Verwenden Sie `transactionId`, um Anfragen bei der Fehleranalyse schneller zu identifizieren. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### basicAuth [object Object],[object Object],[object Object],[object Object],[object Object] Type: http Scheme: basic ### XsollaLoginUserJWT [object Object],[object Object] Type: http Scheme: bearer Bearer Format: JWT ### AuthForCart [object Object],[object Object],[object Object],[object Object],[object Object] Type: http Scheme: bearer ### basicMerchantAuth [object Object],[object Object],[object Object],[object Object] Type: http Scheme: basic ## Download OpenAPI description - [Katalog-API](https://xsolla.redocly.app/_bundle/@l10n/de/api/catalog/index.yaml) ## Übersicht ## Administrator - [GET /v2/project/{project_id}/admin/items/virtual_items](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): Ruft die Liste der virtuellen Gegenstände innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Ruft die Liste der virtuellen Gegenstände innerhalb einer Gruppe zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Ruft den virtuellen Gegenstand innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Aktualisiert einen virtuellen Gegenstand. - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Löscht einen virtuellen Gegenstand. - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Ruft die Liste der virtuellen Währungen innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [POST /v2/project/{project_id}/admin/items/virtual_currency](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Erstellt eine virtuelle Währung. - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Ruft die virtuelle Wärhung innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Aktualisiert eine virtuelle Währung. - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Löscht eine virtuelle Währung. - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Ruft die Liste der virtuellen Währungspakte innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
## Katalog - [GET /v2/project/{project_id}/items/virtual_items](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): Ruft eine List von virtuellen Gegenständen zum Erstellen eines Katalogs ab.
Hinweis

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in de - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): Ruft einen virtuellen Gegenstand anhand der SKU ab, um einen Katalog zu erstellen.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er oh - [GET /v2/project/{project_id}/items/virtual_items/all](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Ruft eine Liste aller virtuellen Gegenstände zur clientseitigen Suche ab.
Hinweis

Gibt nur Artikel-SKU, Name, Gruppen und Beschreibung zurück.

- [GET /v2/project/{project_id}/items/virtual_currency](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Ruft eine List von virtuellen Währungen zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der A - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): Ruft eine virtuelle Währung anhand der SKU ab, um einen Katalog zu erstellen.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Au - [GET /v2/project/{project_id}/items/virtual_currency/package](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Ruft eine Liste von virtuellen Währungspaketen zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie i - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Ruft ein virtuelles Währungspaket anhand der SKU ab, um einen Katalog zu erstellen.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er o - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): Ruft eine Artikelliste aus einer angegebenen Gruppe ab, um einen Katalog zu erstellen.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, di - [GET /v2/project/{project_id}/items/virtual_currency/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-group.md): Ruft eine Liste virtueller Währungen aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artikel be - [GET /v2/project/{project_id}/items/virtual_currency/package/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-group.md): Ruft eine Liste virtueller Währungspakete aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artik ## Virtuelle Bezahlung - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://xsolla.redocly.app/de/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Legt Bestellungen von mit virtueller Währung erworbenen Artikeln an.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autori ## Übersicht ## Katalog - [GET /v2/project/{project_id}/items/game](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-games-list.md): Ruft eine Spieleliste zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erhalten kö - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-games-group.md): Ruft eine Spieleliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-game-by-sku.md): Ruft ein Spiel für den Katalog ab.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verwenden Sie d - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Ruft einen Spielschlüssel für den Katalog ab.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verw - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-game-keys-group.md): Ruft eine Liste von Spielschlüsseln aus der angegebenen Gruppe ab, um einen Katalog zu erstellen.
Achtung

Bei allen Projekten ist die Anzahl der Artikel b - [GET /v2/project/{project_id}/items/game/drm](https://xsolla.redocly.app/de/api/catalog/game-keys-catalog/get-drm-list.md): Ruft die Liste der verfügbaren DRMs ab. ## Berechtigung - [GET /v2/project/{project_id}/entitlement](https://xsolla.redocly.app/de/api/catalog/game-keys-entitlement/get-user-games.md): Ruft eine Liste der Spiele ab, die der Nutzer besitzt. Als Antwort enthält man ein Array von Spielen, die ein bestimmter Nutzer besitzt.
Achtung

Bei allen - [POST /v2/project/{project_id}/entitlement/redeem](https://xsolla.redocly.app/de/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Gewährt die Berechtigung anhand des bereitgestellten Spielcodes.
Hinweis

Sie können Codes nur für die DRM-freie Plattform einlösen.

Achtung

Es können nur Spielcodes oder Spiele für DRM-freie Plattformen gewährt werden.
- [POST /v2/project/{project_id}/admin/entitlement/revoke](https://xsolla.redocly.app/de/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Entzieht dem Nutzer eine Berechtigung.
Achtung

Es können nur Spielcodes oder Spiele für DRM-freie Plattformen entzogen werden.
## Administrator - [POST /v2/project/{project_id}/admin/items/game](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-create-game.md): Erstellt ein Spiel im Projekt. - [GET /v2/project/{project_id}/admin/items/game](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-game-list.md): Ruft eine Liste der Spiele innerhalb eines Projekts zur Verwaltung ab. Das Spiel besteht aus Spielschlüsseln, die von einem Nutzer gekauft werden können.
Hinweis

Verwen - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-game-by-sku.md): Ruft ein Spiel zur Verwaltung ab. Das Spiel besteht aus Spielschlüsseln, die von einem Nutzer gekauft werden können.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Ers - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Aktualisiert ein Spiel im Projekt anhand der SKU. - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Löscht ein Spiel im Projekt anhand der SKU. - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-game-by-id.md): Ruft ein Spiel zur Verwaltung ab. Das Spiel besteht aus Spielschlüsseln, die von einem Nutzer gekauft werden können.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Ers - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-update-game-by-id.md): Aktualisiert ein Spiel im Projekt anhand der ID. - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Löscht ein Spiel im Projekt anhand der ID. - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Lädt Codes anhand der Spielschlüssel-SKU hoch. - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Lädt Codes anhand der Spielschlüssel-ID hoch. - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-codes-session.md): Ruft Sitzungsdaten zum Laden von Codes abrufen ab. - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Ruft eine bestimmte Anzahl von Codes anhand der Spielschlüssel-SKU ab. - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Ruft eine bestimmte Anzahl von Codes anhand der Spielschlüssel-ID ab. - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Löscht alle Codes anhand der Spielschlüssel-SKU. - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Löscht alle Codes anhand der Spielschlüssel-ID. ## Übersicht ## Administrator - [GET /v2/project/{project_id}/admin/items/bundle](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-get-bundle-list.md): Ruft die Liste der Bundles innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [POST /v2/project/{project_id}/admin/items/bundle](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-create-bundle.md): Erstellt ein Bundle – eine Zusammenstellung von Artikeln, die als eine Einheit verkauft werden. Ein Bundle kann virtuelle Gegenstände, virtuelle Währungspakete, Spielschlüssel und andere Bundles entha - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Ruft die Liste der Bundles innerhalb einer Gruppe zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Ruft die Liste der Bundles innerhalb einer Gruppe zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-update-bundle.md): Aktualisiert ein Bundle . Dieser Aufruf ersetzt das Bundle vollständig – übermitteln Sie alle Pflichtfelder im Anfragerumpf, nicht nur die Felder, die Sie ändern möchten. Weitere Informationen finden - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-delete-bundle.md): Löscht ein Bundle. - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-get-bundle.md): Ruft das Bundle innerhalb eines Projekts zur Verwaltung ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.
- [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-show-bundle.md): Zeigt ein Bundle in einem Katalog an. - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://xsolla.redocly.app/de/api/catalog/bundles-admin/admin-hide-bundle.md): Blendet ein Bundle in einem Katalog aus. ## Katalog - [GET /v2/project/{project_id}/items/bundle](https://xsolla.redocly.app/de/api/catalog/bundles-catalog/get-bundle-list.md): Ruft eine Liste von Bundles ab, um einen Katalog zu erstellen.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erh - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://xsolla.redocly.app/de/api/catalog/bundles-catalog/get-bundle.md): Ruft ein angegebenes Bundle ab.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verwenden Sie die - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/bundles-catalog/get-bundle-list-in-group.md): Ruft eine Liste von Bundles innerhalb einer Gruppe ab, um einen Katalog zu erstellen.
Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die ## Übersicht ## Lebenszyklus von Bestellungen ## Warenkorb (clientseitig) - [GET /v2/project/{project_id}/cart/{cart_id}](https://xsolla.redocly.app/de/api/catalog/cart-client-side/get-cart-by-id.md): Gibt den Warenkorb des Nutzers anhand der Warenkorb-ID zurück. - [GET /v2/project/{project_id}/cart](https://xsolla.redocly.app/de/api/catalog/cart-client-side/get-user-cart.md): Gibt den Warenkorb des aktuellen Nutzers zurück. - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://xsolla.redocly.app/de/api/catalog/cart-client-side/cart-clear-by-id.md): Löscht alle Artikel im Warenkorb. - [PUT /v2/project/{project_id}/cart/clear](https://xsolla.redocly.app/de/api/catalog/cart-client-side/cart-clear.md): Löscht alle Artikel im Warenkorb. - [PUT /v2/project/{project_id}/cart/fill](https://xsolla.redocly.app/de/api/catalog/cart-client-side/cart-fill.md): Legt Artikel in den Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird der vorhandene Artikel durch den übergebenen Wert ersetzt. - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://xsolla.redocly.app/de/api/catalog/cart-client-side/cart-fill-by-id.md): Legt Artikel in den angegebene Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird die vorhandene Artikelposition durch den übergebenen Wert ersetzt. - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/cart-client-side/put-item-by-cart-id.md): Aktualisiert einen vorhandenen Warenkorbartikel oder legt den Artikel in den Warenkorb. - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/cart-client-side/delete-item-by-cart-id.md): Entfernt einen Artikel aus dem Warenkorb. - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/cart-client-side/put-item.md): Aktualisiert einen vorhandenen Warenkorbartikel oder legt den Artikel in den Warenkorb. - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/cart-client-side/delete-item.md): Entfernt einen Artikel aus dem Warenkorb. ## Warenkorb (serverseitig) - [PUT /v2/admin/project/{project_id}/cart/fill](https://xsolla.redocly.app/de/api/catalog/cart-server-side/admin-cart-fill.md): Legt Artikel in den aktuellen Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird der vorhandene Artikel durch den übergebenen Wert ersetzt. - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://xsolla.redocly.app/de/api/catalog/cart-server-side/admin-fill-cart-by-id.md): Legt Artikel nach Warenkorb-ID in den Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird der vorhandene Artikel durch den übergebenen Wert ersetzt. ## Zahlung (clientseitig) - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://xsolla.redocly.app/de/api/catalog/payment-client-side/create-order-by-cart-id.md): Wird für die Client-zu-Server-Integration verwendet. Legt eine Bestellung mit allen Artikeln aus dem jeweiligen Warenkorb an und generiert einen Zahlungstoken. Der angelegten Bestellung wird der Beste - [POST /v2/project/{project_id}/payment/cart](https://xsolla.redocly.app/de/api/catalog/payment-client-side/create-order.md): Wird für die Client-zu-Server-Integration verwendet. Legt eine Bestellung mit allen Artikeln aus dem Warenkorb an und generiert einen Zahlungstoken. Der angelegten Bestellung wird der Bestellstatus `n - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/payment-client-side/create-order-with-item.md): Wird für die Client-zu-Server-Integration verwendet. Legt eine Bestellung mit dem angegebenen Artikel an und generiert einen Zahlungstoken. Der angelegten Bestellung wird der Bestellstatus `new` zugeo ## Zahlung (serverseitig) - [POST /v3/project/{project_id}/admin/payment/token](https://xsolla.redocly.app/de/api/catalog/payment-server-side/admin-create-payment-token.md): Generiert eine Bestellung und den zugehörigen Zahlungstoken. Die Bestellung wird auf Grundlage der im Anfragerumpf übermittelten Artikel generiert. Nutzen Sie den folgenden Link, um das Zahlungsportal ## Bestellung - [GET /v2/project/{project_id}/order/{order_id}](https://xsolla.redocly.app/de/api/catalog/order/get-order.md): Ruft eine angegebene Bestellung ab. - [POST /v3/project/{project_id}/admin/order/search](https://xsolla.redocly.app/de/api/catalog/order/admin-order-search.md): Ruft eine Liste der Bestellungen ab, geordnet vom ältesten bis zum jüngsten Erstellungsdatum. ## Kostenlose Artikel - [POST /v2/project/{project_id}/free/cart](https://xsolla.redocly.app/de/api/catalog/free-item/create-free-order.md): Legt eine Bestellung mit allen Artikeln aus dem kostenlosen Warenkorb an. Der angelegten Bestellung wird der Bestellstatus `done` zugewiesen. - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://xsolla.redocly.app/de/api/catalog/free-item/create-free-order-by-cart-id.md): Legt eine Bestellung mit allen Artikeln aus dem jeweiligen kostenlosen Warenkorb an. Der angelegten Bestellung wird der Bestellstatus `done` zugewiesen. - [POST /v2/project/{project_id}/free/item/{item_sku}](https://xsolla.redocly.app/de/api/catalog/free-item/create-free-order-with-item.md): Legt eine Bestellung mit einem angegebenen kostenlosen Artikel an. Der angelegten Bestellung wird der Bestellstatus `done` zugewiesen.
Hinweis

Dieser A ## Übersicht - [Limit-Typen ](https://xsolla.redocly.app/de/api/catalog/limits-overview/limit-types.md): ## Limit-Typen Sie können die folgenden Limit-Typen konfigurieren: * [limits.per_item](/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-item#virtual-items-currency-admin/admin-create - [Konfiguration und Durchsetzung von Limits (Anwendungsszenario) ](https://xsolla.redocly.app/de/api/catalog/limits-overview/limit-configuration-and-enforcement-scenario.md): ## Konfiguration und Durchsetzung von Limits (Anwendungsszenario) Im folgenden Beispiel ist beschrieben, wie ein Kauflimit für einen bestimmten Nutzer konfiguriert wird. Für den Artikel ist der Param ## Verwaltung - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/reset-all-user-items-limit.md): Aktualisiert alle für den angegebenen Nutzer geltenden Artikelkauflimits, damit er diese Artikel wieder kaufen kann. Die entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, wie viele - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/reset-user-item-limit.md): Aktualisiert das Kauflimit für einen Artikel, damit ein Nutzer ihn erneut kaufen kann. Ist dem Parameter *user* der Wert `null` zugewiesen, wird das Limit für alle Nutzer aktualisiert. Die entsprechen - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/get-user-item-limit.md): Ruft die verbleibende Anzahl von Artikeln ab, die der angegebene Nutzer innerhalb des geltenden Limits noch erhalten kann. Die entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, wie - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/add-user-item-limit.md): Erhöht die verbleibende Anzahl von Artikeln, die der angegebene Nutzer innerhalb des geltenden Limits noch erhalten kann. Die entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, wie v - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/set-user-item-limit.md): Legt fest, wie viele Artikel der angegebene Nutzer innerhalb des geltenden Limits kaufen kann, nachdem das Limit erhöht oder verringert wurde. Die entsprechende API (User limit API) ermöglicht es Ihne - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/user-limits-admin/remove-user-item-limit.md): Verringert die verbleibende Anzahl von Artikeln, die der angegebene Nutzer innerhalb des geltenden Limits noch erhalten kann. Die entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, w ## Administrator - [POST /v1/projects/{project_id}/import/from_external_file](https://xsolla.redocly.app/de/api/catalog/connector-admin/import-items-from-external-file.md): Importiert Artikel aus einer JSON-Datei über die angegebene URL in den Shop. Weitere Informationen zum Import aus einer JSON-Datei finden Sie in der [Dokumentation](https://developers.xsolla.com/de/do - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://xsolla.redocly.app/de/api/catalog/connector-admin/get-items-import-status.md): Ruft Informationen darüber ab, wie weit der Import von Artikeln in das Projekt fortgeschritten ist. Der API-Aufruf ruft Daten zum letzten Import ab, der über die API oder das Kundenportal durchgeführt ## Vorbestellungen - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/get-pre-order-limit.md): Rufen Sie das Vorbestelllimit des Artikels ab. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbestellbar sind. Um die Vorbe - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/add-pre-order-limit.md): Ergänzen Sie das Vorbestelllimit des Artikels um eine Mengenangabe. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbestellb - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/set-pre-order-limit.md): Legen Sie eine Mengenangabe für das Vorbestelllimit des Artikels fest. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbeste - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/remove-pre-order-limit.md): Entfernen Sie eine Mengenangabe für das Vorbestelllimit des Artikels. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbestel - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Aktiviert/deaktiviert das Vorbestelllimit des Artikels. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbestellbar sind. Um - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://xsolla.redocly.app/de/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): Entfernen Sie alle Mengenangaben für das Vorbestelllimit des Artikels. Die entsprechende API (Pre-Order limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal vorbeste ## Händler - [GET /v2/merchant/{merchant_id}/projects](https://xsolla.redocly.app/de/api/catalog/common-merchant/get-projects.md): Ruft die Liste der Projekte des Händlers ab.

Bemerkung

Dieser API-Aufruf enthält nicht den Pfadparameter project_id, Sie müssen also den AP ## Katalog - [GET /v2/project/{project_id}/items](https://xsolla.redocly.app/de/api/catalog/common-catalog/get-sellable-items.md): Ruft eine Liste der verkäuflichen Artikel zum Erstellen eines Katalogs ab.

Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der - [GET /v2/project/{project_id}/items/id/{item_id}](https://xsolla.redocly.app/de/api/catalog/common-catalog/get-sellable-item-by-id.md): Ruft einen verkäuflichen Artikel anhand seiner ID ab.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wi - [GET /v2/project/{project_id}/items/sku/{sku}](https://xsolla.redocly.app/de/api/catalog/common-catalog/get-sellable-item-by-sku.md): Ruft einen verkäuflichen Artikel anhand der SKU ab, um einen Katalog zu erstellen.
Hinweis

Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er oh - [GET /v2/project/{project_id}/items/group/{external_id}](https://xsolla.redocly.app/de/api/catalog/common-catalog/get-sellable-items-group.md): Ruft eine Liste der verkäuflichen Artikel aus der angegebenen Gruppe ab, um einen Katalog zu erstellen.
Achtung

Bei allen Projekten ist die Anzahl der Art ## Gängige Regionen - [GET /v2/project/{project_id}/admin/region](https://xsolla.redocly.app/de/api/catalog/common-regions/admin-get-regions.md): Ruft eine Liste der Regionen ab. Anhand von Regionen können Sie regionale Beschränkungen verwalten. - [POST /v2/project/{project_id}/admin/region](https://xsolla.redocly.app/de/api/catalog/common-regions/admin-create-region.md): Erstellt eine Region. Anhand von Regionen können Sie regionale Beschränkungen verwalten. - [GET /v2/project/{project_id}/admin/region/{region_id}](https://xsolla.redocly.app/de/api/catalog/common-regions/admin-get-region.md): Ruft eine bestimmte Region ab. Anhand von Regionen können Sie regionale Beschränkungen verwalten. - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://xsolla.redocly.app/de/api/catalog/common-regions/admin-update-region.md): Aktualisiert eine bestimmte Region. Anhand von Regionen können Sie regionale Beschränkungen verwalten. - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://xsolla.redocly.app/de/api/catalog/common-regions/admin-delete-region.md): Löscht eine bestimmte Region. ## Webhooks - [PUT /v2/project/{project_id}/admin/webhook/version](https://xsolla.redocly.app/de/api/catalog/common-webhooks/update-webhook-version.md): Aktualisiert die Webhook-Version für das Projekt. In Version 2 sind zusätzliche Parameter im `items`-Array enthalten. Weitere Informationen zu Webhooks finden Sie unter [Bestellstatus-Tracking einrich ## Administrator - [GET /v2/project/{project_id}/admin/attribute](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-get-attribute-list.md): Ruft die Liste der Attribute aus einem Projekt zur Verwaltung ab. - [POST /v2/project/{project_id}/admin/attribute](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-create-attribute.md): Erstellt ein Attribut. - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-update-attribute.md): Aktualisiert ein Attribut. - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-get-attribute.md): Ruft ein angegebenes Attribut ab. - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://xsolla.redocly.app/de/api/catalog/attribute-admin/delete-attribute.md): Löscht ein Attribut.
Hinweis

Wenn Sie ein Artikelattribut löschen, gehen alle zugehörigen Daten und Verbindungen zu anderen Artikeln verloren.
- [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-create-attribute-value.md): Erstellt einen Attributwert.
Achtung

Bei allen Projekten ist die Anzahl der Attributwerte begrenzt. Der Standard- und Höchstwert beträgt 20 Werte pr - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Löscht alle Werte des Attributs.
Hinweis

Wenn Sie den Wert eines Attributs löschen, gehen alle Verbindungen zwischen dem Attribut und den Artikeln verloren. - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-update-attribute-value.md): Aktualisiert einen Attributwert. - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://xsolla.redocly.app/de/api/catalog/attribute-admin/admin-delete-attribute-value.md): Löscht einen Attributwert.
Hinweis

Wenn Sie den Wert eines Attributs löschen, gehen alle Verbindungen zwischen dem Attribut und den Artikeln verloren. Verwe ## Administrator - [GET /v2/project/{project_id}/admin/items/groups](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-get-item-group-list.md): Ruft die vollständige Liste der Artikelgruppen innerhalb eines Projekts ohne Paginierung ab. Für Verwaltungszwecke.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erst - [POST /v2/project/{project_id}/admin/items/groups](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-create-item-group.md): Erstellt eine Artikelgruppe innerhalb eines Projekts. Verwenden Sie den clientseitigen Endpunkt Liste der Artikelgruppen abrufen, um A - [GET /v2/project/{project_id}/admin/items/groups/{external_id}](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-get-item-group.md): Ruft eine Artikelgruppe anhand ihrer externen ID für Verwaltungszwecke ab.
Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shopkatalogs. Verwenden Sie s - [PUT /v2/project/{project_id}/admin/items/groups/{external_id}](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-update-item-group.md): Aktualisiert eine Artikelgruppe anhand ihrer externen ID. - [DELETE /v2/project/{project_id}/admin/items/groups/{external_id}](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-delete-item-group.md): Löscht eine Artikelgruppe anhand ihrer externen ID. - [GET /v2/project/{project_id}/admin/items/{item_type}/groups](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-get-item-group-list-by-item-type.md): Ruft eine Liste von Artikelgruppen ab, gefiltert nach Artikeltyp. Für die Gruppe werden nur Artikel des angegebenen Typs gezählt. Ähnelt dem Endpunkt [Artikelgruppenliste abrufen](/de/api/catalog/item - [GET /v2/project/{project_id}/admin/items/{item_type}/groups/{external_id}](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-get-item-group-by-item-type.md): Ruft eine Artikelgruppe anhand der externen ID ab. Für die Gruppe werden nur Artikel des angegebenen Typs gezählt. Ähnelt dem Endpunkt [Artikelgruppe anhand der externen ID abrufen](/de/api/catalog/it - [PUT /v2/project/{project_id}/admin/group/order](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-reorder-item-groups.md): Legt die Anzeigereihenfolge für Artikelgruppen innerhalb eines Projekts fest. Übermitteln Sie ein Array von Gruppen mit deren neuen Reihenfolgewerten. - [PUT /v2/project/{project_id}/admin/group/{external_id}/order/item](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-reorder-items-in-group.md): Legt die Anzeigereihenfolge von Artikeln innerhalb einer Gruppe fest, die durch ihre externe ID identifiziert wird. Übermitteln Sie ein Array von Artikeln mit deren neuen Reihenfolgewerten. - [PUT /v2/project/{project_id}/admin/group/id/{id}/order/item](https://xsolla.redocly.app/de/api/catalog/item-groups-admin/admin-reorder-items-in-group-by-id.md): Legt die Anzeigereihenfolge von Artikeln innerhalb einer Gruppe fest, die durch ihre interne numerische ID identifiziert wird. Übermitteln Sie ein Array von Artikeln mit deren neuen Reihenfolgewerten. ## Katalog - [GET /v2/project/{project_id}/items/groups](https://xsolla.redocly.app/de/api/catalog/item-groups-catalog/get-item-groups.md): Ruft eine Liste von Artikelgruppen zum Erstellen eines Katalogs ohne Paginierung ab.
Hinweis

Die API-Aufrufe für den Artikelkatalog können auch ohne Autorisierung verwe