# Catalog API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Catalog API bietet Endpunkte zur Verwaltung Ihres In-Game-Store-Katalogs und zur Abwicklung von Käufen. Verwenden Sie die Endpunkte zum Konfigurieren von virtuellen Gegenständen, virtuellen Währungen, Spielschlüsseln, Bundles, Warenkorb- und Zahlungsabläufen sowie Artikelattributen und zum Importieren von Artikeln aus externen Quellen. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart Wenn Sie einen Warenkorb mit Spielen verkaufen, können Sie [den Endpunkt ohne Autorisierung aufrufen](/de/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users). So geht's: * Fügen Sie eine eindeutige Kennung zum Parameter `x-unauthorized-id` im Header für Spiele hinzu. * Ergänzen Sie den Parameter `x-user` (Base64-codiert) im Header um die E-Mail-Adresse des Nutzers. Standardmäßig wird der Xsolla-Login-Benutzer-JWT (Trägertoken) zur Autorisierung verwendet. Sie können versuchen, diesen Endpunkt mit einem speziell für Testzwecke bestehenden Xsolla-Login-Benutzer-JWT aufzurufen: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Alternativ können Sie den [Zugriffstoken der Bezahlstation](https://developers.xsolla.com/de/api/pay-station/operation/create-token/) verwenden. Type: http Scheme: bearer ### XsollaLoginUserJWT Standardmäßig wird der Xsolla-Login-Benutzer-JWT (Trägertoken) bei der Autorisierung verwendet. Sie können versuchen, diesen Endpunkt mit einem speziell für Testzwecke bestehenden Xsolla-Login-Benutzer-JWT aufzurufen: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Alternativ können Sie den [Zugriffstoken der Bezahlstation](https://developers.xsolla.com/de/api/pay-station/operation/create-token/) verwenden. Type: http Scheme: bearer Bearer Format: JWT ### basicAuth Die Xsolla-API nutzt die Basisauthentifizierung. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` das gemäß Base64-Standard kodierte `project_id:api_key`-Paar ist. Sie können bei Bedarf `merchant_id` anstelle von `project_id` verwenden. Dies hat keine Auswirkungen auf die Funktionalität. Wechseln Sie ins [Kundenportal](https://publisher.xsolla.com/), um die Werte der Parameter zu erhalten: * Die `merchant_id` wird an folgenden Orten 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/`. * Der `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen: * **Firmeneinstellungen > API-Schlüssel** * **Projekteinstellungen > API-Schlüssel** * Die `project_id` wird an folgenden Orten angezeigt: * Im Kundenportal neben dem Projektnamen. * In der URL in der Adressleiste des Browsers, wenn Sie im Kundenportal an einem Projekt arbeiten. Die URL hat das folgende Format: `https://publisher.xsolla.com//Projekte/`. Weitere Informationen zur Handhabung von API-Schlüsseln finden Sie in der [API-Referenz](https://developers.xsolla.com/de/api/getting-started/#api_keys_overview). Type: http Scheme: basic ### basicMerchantAuth Die Xsolla-API nutzt die Basisauthentifizierung. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` das gemäß Base64-Standard kodierte `merchant_id:api_key`-Paar ist. Wechseln Sie ins [Kundenportal](https://publisher.xsolla.com/), um die Werte der Parameter zu erhalten: * Die `merchant_id` wird an folgenden Orten 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/` * Der `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen: * **Firmeneinstellungen > API-Schlüssel** * **Projekteinstellungen > API-Schlüssel** Weitere Informationen zur Handhabung von API-Schlüsseln finden Sie in der [API-Referenz](https://developers.xsolla.com/de/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Catalog API](https://developers.xsolla.com/_bundle/@l10n/de/api/catalog/index.yaml) ## Verwaltung ### Liste virtueller Währungen abrufen - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuelle Währung erstellen - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Erstellt eine virtuelle Währung. ### Liste der virtuellen Währungspakete abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuelles Währungspaket erstellen - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Erstellt ein virtuelles Währungspaket. ### Virtuelles Währungspaket löschen - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Löscht ein virtuelles Währungspaket. ### Virtuelles Währungspaket abrufen - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Ruft das virtuelle Wärhungspaket innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuelles Währungspaket aktualisieren - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Aktualisiert ein virtuelles Währungspaket. ### Virtuelle Währung löschen - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Löscht eine virtuelle Währung. ### Virtuelle Währung abrufen - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Ruft die virtuelle Wärhung innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuelle Währung aktualisieren - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Aktualisiert eine virtuelle Währung. ### Liste virtueller Gegenstände abrufen - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuellen Gegenstand erstellen - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): Erstellt einen virtuellen Gegenstand. ### Liste der virtuellen Gegenstände anhand der angegebenen externen Gruppen-ID abrufen - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Ruft die Liste der virtuellen Gegenstände innerhalb einer Gruppe zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Liste der virtuellen Gegenstände anhand der angegebenen Gruppen-ID abrufen - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuellen Gegenstand löschen - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Löscht einen virtuellen Gegenstand. ### Virtuellen Gegenstand abrufen - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Ruft den virtuellen Gegenstand innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Virtuellen Gegenstand aktualisieren - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Aktualisiert einen virtuellen Gegenstand. ## Katalog ### Liste der Artikelgruppen abrufen - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-item-groups.md): Ruft eine Liste der Artikelgruppen zum Erstellen eines Katalogs ab. ### Liste virtueller Währungen abrufen - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Ruft eine List von virtuellen Währungen 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. ### Liste virtueller Währungspakete abrufen - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Ruft eine Liste von virtuellen Währungspaketen 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. ### Virtuelles Währungspaket anhand der SKU abrufen - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/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. 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. ### Virtuelle Währung anhand der SKU abrufen - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/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. 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. ### Liste virtueller Gegenstände abrufen - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): 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. ### Liste aller virtuellen Gegenstände abrufen - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Ruft eine Liste aller virtuelle Gegenstände zum clientseitigen Durchsuchen ab. AchtungGibt nur Artikel-SKU, Name, Gruppen und Beschreibung zurück 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. ### Artikelliste anhand angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/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. AchtungBei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie erhalten können in der Antwort. 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. 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. ### Virtuellen Gegenstand anhand der SKU abrufen - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/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. 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. ## Virtuelle Bezahlung ### Bestellung mit einem angegebenen, in virtueller Währung gekauften Artikel anlegen - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/de/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Legt Bestellungen von mit virtueller Währung erworbenen Artikeln an. ## Katalog ### Spieleliste abrufen - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/de/api/catalog/game-keys-catalog/get-games-list.md): Ruft eine Spieleliste 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. ### DRM-Liste abrufen - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/de/api/catalog/game-keys-catalog/get-drm-list.md): Ruft die Liste der verfügbaren DRMs ab. ### Spieleliste anhand angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/de/api/catalog/game-keys-catalog/get-games-group.md): Ruft eine Spieleliste aus der angegebenen Gruppe 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. ### Liste der Spielschlüssel anhand angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/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. 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. ### Spielschlüssel für den Katalog abrufen - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Ruft einen Spielschlüssel für den Katalog ab. HinweisAuf diesen Endpunkt kann man ohne Autorisierung zugreifen, er gibt generische Daten zurück. Liegt eine Autorisierung vor, ist die Antwort jedoch mit benutzerspezifischen Details (z. B. vorhandene Nutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis. ### Spiel für den Katalog abrufen - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-catalog/get-game-by-sku.md): Ruft ein Spiel für den Katalog ab. HinweisAuf diesen Endpunkt kann man ohne Autorisierung zugreifen, er gibt generische Daten zurück. Liegt eine Autorisierung vor, ist die Antwort jedoch mit benutzerspezifischen Details (z. B. vorhandene Nutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis. ## Berechtigung ### Berechtigung erteilen (Verwaltung) - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/de/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): Erteilt dem Nutzer eine Berechtigung. AchtungEs können nur Spielcodes oder Spiele für DRM-freie Plattformen gewährt werden. ### Berechtigung entziehen (Verwaltung) - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/de/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Entzieht dem Nutzer eine Berechtigung. AchtungEs können nur Spielcodes oder Spiele für DRM-freie Plattformen entzogen werden. ### Liste der Spiele im Besitz des Nutzers abrufen - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/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. 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 pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset. ### Spielcode durch Client einlösen - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/de/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Gewährt die Berechtigung anhand des bereitgestellten Spielcodes. AchtungSie können Codes nur für die DRM-freie Plattform einlösen. ## Verwaltung ### Spieleliste abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Spiel erstellen - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-create-game.md): Erstellt ein Spiel im Projekt. ### Spiel anhand der ID löschen - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Löscht ein Spiel im Projekt anhand der ID. ### Spiel anhand von ID abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Spiel anhand der ID aktualisieren - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-update-game-by-id.md): Aktualisiert ein Spiel im Projekt anhand der ID. ### Codes anhand der ID löschen - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Löscht alle Codes anhand der Spielschlüssel-ID. ### Codes löschen - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Löscht alle Codes anhand der Spielschlüssel-SKU. ### Codes anhand der ID abrufen - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Ruft eine bestimmte Anzahl von Codes anhand der Spielschlüssel-ID ab. ### Codes abrufen - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Ruft eine bestimmte Anzahl von Codes anhand der Spielschlüssel-SKU ab. ### Codes anhand von ID hochladen - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Lädt Codes anhand der Spielschlüssel-ID hoch. ### Sitzungsdaten zum Laden von Codes abrufen - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-get-codes-session.md): Ruft Sitzungsdaten zum Laden von Codes abrufen ab. ### Codes hochladen - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Lädt Codes anhand der Spielschlüssel-SKU hoch. ### Spiel anhand der SKU löschen - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Löscht ein Spiel im Projekt anhand der SKU. ### Spiel abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Spiel anhand der SKU aktualisieren - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Aktualisiert ein Spiel im Projekt anhand der SKU. ## Verwaltung ### Liste der Bundles abrufen - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-get-bundle-list.md): Ruft die Liste der Bundles innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Bundle erstellen - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-create-bundle.md): Erstellt ein Bundle. ### Liste der Bundles anhand der angegebenen externen Gruppen-ID abrufen - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Liste der Bundles anhand der angegebenen Gruppen-ID abrufen - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/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. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Bundle löschen - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-delete-bundle.md): Löscht ein Bundle. ### Bundle abrufen - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-get-bundle.md): Ruft das Bundle innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. ### Bundle aktualisieren - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-update-bundle.md): Aktualisiert ein Bundle. ### Bundle im Katalog ausblenden - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-hide-bundle.md): Blendet ein Bundle in einem Katalog aus. ### Bundle im Katalog anzeigen - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/de/api/catalog/bundles-admin/admin-show-bundle.md): Zeigt ein Bundle in einem Katalog an. ## Katalog ### Liste der Bundles abrufen - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/de/api/catalog/bundles-catalog/get-bundle-list.md): Ruft eine Liste von Bundles ab, um einen Katalog zu erstellen. 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. 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. ### Liste der Bundles anhand der angegebenen Gruppe abrufen - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/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. 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. 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. ### Angegebenes Bundle abrufen - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/de/api/catalog/bundles-catalog/get-bundle.md): 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. ## Warenkorb (clientseitig) ### Warenkorb des aktuellen Benutzers abrufen - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/de/api/catalog/cart-client-side/get-user-cart.md): Gibt den Warenkorb des aktuellen Nutzers zurück. ### Alle Warenkorbartikel aus dem aktuellen Warenkorb löschen - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/de/api/catalog/cart-client-side/cart-clear.md): Löscht alle Artikel im Warenkorb. ### Artikel in den Warenkorb legen - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/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. ### Warenkorbartikel aus aktuellem Warenkorb löschen - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/de/api/catalog/cart-client-side/delete-item.md): Entfernt einen Artikel aus dem Warenkorb. ### Warenkorbartikel aus dem aktuellem Warenkorb aktualisieren - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/de/api/catalog/cart-client-side/put-item.md): Aktualisiert einen vorhandenen Warenkorbartikel oder legt den Artikel in den Warenkorb. ### Warenkorb anhand von Warenkorb-ID abrufen - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/de/api/catalog/cart-client-side/get-cart-by-id.md): Gibt den Warenkorb des Nutzers anhand der Warenkorb-ID zurück. ### Alle Warenkorbartikel anhand der Warenkorb-ID löschen - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/de/api/catalog/cart-client-side/cart-clear-by-id.md): Löscht alle Artikel im Warenkorb. ### Artikel in den angegeben Warenkorb legen - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/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. ### Warenkorbartikel anhand der Warenkorb-ID löschen - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/de/api/catalog/cart-client-side/delete-item-by-cart-id.md): Entfernt einen Artikel aus dem Warenkorb. ### Warenkorbartikel anhand der Warenkorb-ID aktualisieren - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/de/api/catalog/cart-client-side/put-item-by-cart-id.md): Aktualisiert einen vorhandenen Warenkorbartikel oder legt den Artikel in den Warenkorb. ## Warenkorb (serverseitig) ### Artikel in den Warenkorb legen - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/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. ### Warenkorb anhand der Warenkorb-ID mit Artikeln zusammenstellen - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/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) ### Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/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 new zugeordnet. Anhand der Client-IP wird das Land des Nutzers ermittelt und anschließend die entsprechende Währung und die verfügbaren Zahlungsmethoden für die Bestellung herangezogen. Nutzen Sie den folgenden Link, um das Zahlungsportal in einem neuen Fenster aufzurufen: https://secure.xsolla.com/paystation4/?token={token}, wobei {token} der erhaltene Token ist. Für Testzwecke steht Ihnen die folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Hinweis Weil diese Methode auf die IP zurückgreift, um das Land des Nutzers zu ermitteln und eine Währung für die Bestellung auszuwählen, ist es wichtig, diese Methode nur clientseitig und nicht serverseitig einzusetzen. Die serverseitige Verwendung dieser Methode kann dazu führen, dass eine falsche Währung ermittelt wird, was sich wiederum auf die in der Pay Station angezeigten Zahlungsmethoden auswirkt. ### Bestellung mit allen Artikeln aus einem angegebenen Warenkorb anlegen - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/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 Bestellstatus new zugeordnet. Anhand der Client-IP wird das Land des Nutzers ermittelt und anschließend die entsprechende Währung und die verfügbaren Zahlungsmethoden für die Bestellung herangezogen. Nutzen Sie den folgenden Link, um das Zahlungsportal in einem neuen Fenster aufzurufen: https://secure.xsolla.com/paystation4/?token={token}, wobei {token} der erhaltene Token ist. Für Testzwecke steht Ihnen die folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Hinweis Weil diese Methode auf die IP zurückgreift, um das Land des Nutzers zu ermitteln und eine Währung für die Bestellung auszuwählen, ist es wichtig, diese Methode nur clientseitig und nicht serverseitig einzusetzen. Die serverseitige Verwendung dieser Methode kann dazu führen, dass eine falsche Währung ermittelt wird, was sich wiederum auf die in der Pay Station angezeigten Zahlungsmethoden auswirkt. ### Bestellung mit angegebenem Artikel anlegen - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/de/api/catalog/payment-client-side/create-order-with-item.md): Wird für die Client-zu-Server-Integration verwendet. Legt eine Bestellung mit einem bestimmten Artikel an und generiert einen Zahlungstoken. Der angelegten Bestellung wird der Bestellstatus new zugeordnet. Anhand der Client-IP wird das Land des Nutzers ermittelt und anschließend die entsprechende Währung und die verfügbaren Zahlungsmethoden für die Bestellung herangezogen. Nutzen Sie den folgenden Link, um das Zahlungsportal in einem neuen Fenster aufzurufen: https://secure.xsolla.com/paystation4/?token={token}, wobei {token} der erhaltene Token ist. Für Testzwecke steht Ihnen die folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Hinweis Weil diese Methode auf die IP zurückgreift, um das Land des Nutzers zu ermitteln und eine Währung für die Bestellung auszuwählen, ist es wichtig, diese Methode nur clientseitig und nicht serverseitig einzusetzen. Die serverseitige Verwendung dieser Methode kann dazu führen, dass eine falsche Währung ermittelt wird, was sich wiederum auf die in der Pay Station angezeigten Zahlungsmethoden auswirkt. ## Zahlung (serverseitig) ### Zahlungstoken für den Kauf erstellen - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/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 folgenden Link, um das Zahlungsportal in einem neuen Fenster aufzurufen: https://secure.xsolla.com/paystation4/?token={token}, wobei {token} der empfangene Token ist. Für Testzwecke steht Ihnen die folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Hinweis Der Paramter user.country.value dient dazu, eine Währung für die Bestellung auszuwählen. Ist das Land des Nutzers unbekannt, ist auch die Angabe der IP-Adresse des Nutzers im Header X-User-Ip möglich. Damit die Methode ordnungsgemäß funktioniert, ist eine dieser beiden Optionen erforderlich. Die ausgewählte Währung wird für die Zahlungsmethoden in Pay Station genutzt. ## Bestellung ### Bestellung abrufen - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/de/api/catalog/order/get-order.md): Ruft eine angegebene Bestellung ab. ### Bestellliste für angegebenen Zeitraum abrufen - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/de/api/catalog/order/admin-order-search.md): Ruft eine Liste der Bestellungen ab, geordnet vom ältesten bis zum jüngsten Erstellungsdatum. ## Kostenlose Artikel ### Bestellung mit einem kostenlosen Warenkorb anlegen - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/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. ### Bestellung mit einem bestimmten kostenlosen Warenkorb anlegen - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/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. ### Bestellung mit angegebenem kostenlosen Artikel anlegen - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/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. ## Verwaltung ### Alle Kauflimits für den angegebenen Benutzer aktualisieren - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/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 Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ### Anzahl der für einen bestimmten Benutzer verfügbaren Artikel reduzieren - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/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, wie viele Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ### Anzahl der für einen bestimmten Benutzer verfügbaren Artikel abrufen - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/de/api/catalog/user-limits-admin/get-user-item-limit.md): Ruft ab, wie viele Artikel der angegebene Nutzer innerhalb des geltenden Limits noch erhalten kann. Die entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ### Anzahl der für einen bestimmten Benutzer verfügbaren Artikel erhöhen - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 viele Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ### Anzahl der für einen bestimmten Benutzer verfügbaren Artikel festlegen - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ### Kauflimit aktualisieren - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/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 entsprechende API (User limit API) ermöglicht es Ihnen, festzulegen, wie viele Einheiten eines Artikels maximal erhältlich sind. Um die Kauflimits selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Artikeltypmoduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles ## Verwaltung ### Status des Artikelimports abrufen - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/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 wurde. ### Artikel aus JSON-Datei importieren - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/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. ## Webhooks ### Informationen zu Webhook-Einstellungen abrufen - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/de/api/catalog/common-webhooks/get-webhook.md): Ruft die Informationen über die Webhook-Einstellungen in Store ab. Mehr dazu erfahren Sie in der Webhook-Dokumentation. ### Informationen zu Webhook-Einstellungen aktualisieren - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/de/api/catalog/common-webhooks/update-webhook.md): Aktualisiert die Informationen über die Webhook-Einstellungen in Store. Mehr dazu erfahren Sie in der Webhook-Dokumentation. ## Vorbestellungen ### Mengenangabe für das Vorbestelllimit des Artikels entfernen - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 vorbestellbar sind. Um die Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Informationen zum Artikelvorbestelllimit abrufen - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Artikelvorbestelllimit um Mengenangabe ergänzen - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 vorbestellbar sind. Um die Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Mengenangabe für das Vorbestelllimit des Artikels festlegen - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/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 vorbestellbar sind. Um die Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Alle Mengenangaben für das Vorbestelllimit des Artikels entfernen - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/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 vorbestellbar sind. Um die Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### Vorbestelllimit des Artikels aktivieren/deaktivieren - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/de/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Aktivieren bzw. deaktivieren Sie 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 die Vorbestellung selbst zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" des gewünschten Moduls: * Spielschlüssel * Virtuelle Gegenstände und Währung * Bundles Aliasse für diesen Endpunkt: * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ## Händler ### Projekte abrufen - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/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 API-Schlüssel verwenden, der in allen Projekten des Unternehmens gültig ist, um die Autorisierung einzurichten. ## Katalog Diese API ermöglicht es, jede Art von verkäuflichen oder bestimmten Artikeln zu erhalten. ### Liste der verkäuflichen Artikel abrufen - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/de/api/catalog/common-catalog/get-sellable-items.md): Ruft eine Liste der verkäuflichen Artikel 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. ### Verkäuflichen Artikel anhand von ID abrufen - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/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. 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. ### Verkäuflichen Artikel anhand von SKU abrufen - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/de/api/catalog/common-catalog/get-sellable-item-by-id.md): Ruft einen verkäuflichen Artikel anhand seiner ID 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. ### Liste der verkäuflichen Artikel anhand von angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/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. 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. ## Gängige Regionen ### Liste der Regionen abrufen - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/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. ### Region erstellen - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/de/api/catalog/common-regions/admin-create-region.md): Erstellt eine Region. Anhand von Regionen können Sie regionale Beschränkungen verwalten. ### Region löschen - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/de/api/catalog/common-regions/admin-delete-region.md): Löscht eine bestimmte Region. ### Region abrufen - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/de/api/catalog/common-regions/admin-get-region.md): Ruft eine bestimmte Region ab. Anhand von Regionen können Sie regionale Beschränkungen verwalten. ### Region aktualisieren - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/de/api/catalog/common-regions/admin-update-region.md): Aktualisiert eine bestimmte Region. Anhand von Regionen können Sie regionale Beschränkungen verwalten. ## Verwaltung ### Liste der Attribute abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-get-attribute-list.md): Ruft die Liste der Attribute aus einem Projekt zur Verwaltung ab. ### Attribut erstellen - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-create-attribute.md): Erstellt ein Attribut. ### Attribut löschen - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/de/api/catalog/attribute-admin/delete-attribute.md): Löscht ein Attribut. HinweisWenn Sie ein Artikelattribut löschen, gehen alle zugehörigen Daten und Verbindungen zu anderen Artikeln verloren. ### Angegebenes Attribut abrufen - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-get-attribute.md): Ruft ein angegebenes Attribut ab. ### Attribut aktualisieren - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-update-attribute.md): Aktualisiert ein Attribut. ### Alle Werte des Attributs löschen - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Löscht alle Werte des Attributs. HinweisWenn Sie den Wert eines Attributs löschen, gehen alle Verbindungen zwischen dem Attribut und den Artikeln verloren. Verwenden Sie zum Ändern des Attributwerts eines Artikels den API-Aufruf Attributwert aktualisieren, anstatt den Wert zu löschen und einen neuen zu erstellen. ### Attributwert erstellen - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-create-attribute-value.md): Erstellt einen Attributwert. AchtungBei allen Projekten ist die Anzahl der Attributwerte begrenzt. Der Standard- und Höchstwert beträgt 20 Werte pro Attribut. ### Attributwert löschen - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-delete-attribute-value.md): Löscht einen Attributwert. HinweisWenn Sie den Wert eines Attributs löschen, gehen alle Verbindungen zwischen dem Attribut und den Artikeln verloren. Verwenden Sie zum Ändern des Attributwerts eines Artikels den API-Aufruf Attributwert aktualisieren, anstatt den Wert zu löschen und einen neuen zu erstellen. ### Attributwert aktualisieren - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/de/api/catalog/attribute-admin/admin-update-attribute-value.md): Aktualisiert einen Attributwert.