# Shop Builder 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 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. 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 [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/de/api/shop-builder/index.yaml) ## Verwaltung ### Liste der Attribute abrufen (Verwaltung) - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/attribute-admin/admin-update-attribute-value.md): Aktualisiert einen Attributwert. ## Personalisierter Katalog Diese API ermöglicht es, Regeln für Benutzerattribute festzulegen. Wenn der Nutzer alle Bedingungen einer konkreten Regel erfüllt, werden personalisierte Artikel angezeigt. Für personalisierte Werbeaktionen siehe Abschnitt [Werbeaktionen](/de/api/shop-builder/tag/promotions-discounts). Um Attribute vor einem Kauf zu übermitteln, können Sie die [Xsolla Login API](/de/api/login/operation/update-users-attributes-from-server/) verwenden oder die Attribute in der [Eigenschaft user.attributes übermitteln, während Sie den Token mit der Pay Station API generieren](/de/api/pay-station/operation/create-token). ### Liste der Katalogfilterregeln abrufen - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/get-filter-rules.md): Ruft alle Regeln ab, die für Benutzerattribute gelten. ### Katalogfilterregel erstellen - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/create-filter-rule.md): Erstellt Regeln für Benutzerattribute. ### Alle Katalogregeln zum clientseitigen Durchsuchen abrufen - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/get-all-filter-rules.md): Ruft eine Liste aller Katalogregeln zum clientseitigen Durchsuchen ab. AchtungGibt nur die Regel-ID, den Namen und is_enabled zurück ### Katalogfilterregel löschen - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/delete-filter-rule-by-id.md): Löscht eine bestimmte Regel. ### Katalogfilterregel abrufen - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/get-filter-rule-by-id.md): Bestimmte für Benutzerattribute geltende Regel abrufen ### Katalogfilterregel patchen - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/patch-filter-rule-by-id.md): Aktualisiert eine bestimmte Regel, die für Benutzerattribute gilt. Bei einer unbestimmten Eigenschaft wird der aktuelle Wert verwendet. ### Katalogfilterregel aktualisieren - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/shop-builder/personalized-catalog/update-filter-rule-by-id.md): Aktualisiert eine bestimmte Regel, die für Benutzerattribute gilt. Bei einer unbestimmten Eigenschaft wird der Standardwert verwendet (wenn die Eigenschaft nicht erforderlich ist). ## Verwaltung ### Liste der Bundles abrufen - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ### Bestellung für kostenpflichtigen Angebotskettenschritt anlegen - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/de/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Legt eine Bestellung für den Artikel an, der mit dem angegebenen kostenpflichtigen Angebotskettenschritt verknüpft ist. Der angelegten Bestellung wird der Status new zugewiesen. Öffnen Sie das Zahlungsportal in einem neuen Fenster mithilfe des folgenden Links: 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 Diese Methode muss clientseitig verwendet werden. Anhand der IP-Adresse des Nutzers wird das Land ermittelt und davon wiederum die Währung und die verfügbaren Zahlungsmethoden abgeleitet. Wird diese Methode serverseitig verwendet, wird mögliccherweise eine falsche Währung ermittelt, was sich wiederum auf die Zahlungsmethoden in Pay Station auswirkt. Hinweis Verwenden Sie diesen Aufruf nur bei kostenpflichtigen Schritten in der Angebotskette. Bei kostenlosen Schritten müssen Sie stattdessen den Aufruf Kostenlosen Angebotskettenschritt sichern verwenden. ### Bestellung für kostenpflichtigen Angebotskettenschritt anlegen - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/de/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Legt eine Bestellung für den Artikel an, der mit dem angegebenen kostenpflichtigen Angebotskettenschritt verknüpft ist. Der angelegten Bestellung wird der Status new zugewiesen. Öffnen Sie das Zahlungsportal in einem neuen Fenster mithilfe des folgenden Links: 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 Diese Methode muss clientseitig verwendet werden. Anhand der IP-Adresse des Nutzers wird das Land ermittelt und davon wiederum die Währung und die verfügbaren Zahlungsmethoden abgeleitet. Wird diese Methode serverseitig verwendet, wird mögliccherweise eine falsche Währung ermittelt, was sich wiederum auf die Zahlungsmethoden in Pay Station auswirkt. Hinweis Verwenden Sie diesen Aufruf nur bei kostenpflichtigen Schritten in der Angebotskette. Bei kostenlosen Schritten müssen Sie stattdessen den Aufruf Kostenlosen Angebotskettenschritt sichern verwenden. ## Client ### Bestellung für kostenpflichtigen Angebotskettenschritt anlegen - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/de/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): Legt eine Bestellung für den Artikel an, der mit dem angegebenen kostenpflichtigen Angebotskettenschritt verknüpft ist. Der angelegten Bestellung wird der Status new zugewiesen. Öffnen Sie das Zahlungsportal in einem neuen Fenster mithilfe des folgenden Links: 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 Diese Methode muss clientseitig verwendet werden. Anhand der IP-Adresse des Nutzers wird das Land ermittelt und davon wiederum die Währung und die verfügbaren Zahlungsmethoden abgeleitet. Wird diese Methode serverseitig verwendet, wird mögliccherweise eine falsche Währung ermittelt, was sich wiederum auf die Zahlungsmethoden in Pay Station auswirkt. Hinweis Verwenden Sie diesen Aufruf nur bei kostenpflichtigen Schritten in der Angebotskette. Bei kostenlosen Schritten müssen Sie stattdessen den Aufruf Kostenlosen Angebotskettenschritt sichern verwenden. ### Angebotsketten des aktuellen Nutzers abrufen - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/de/api/shop-builder/offer-chain-client/get-offer-chains-list.md): Ruft die aktuellen Angebotsketten des Nutzers ab. HinweisIn allen Projekten ist die Anzahl der Artikel, die in einer einzigen Antwort zurückgegeben werden können, begrenzt. Der Standard- und Maximalwert beträgt 30 Artikel pro Antwort. Verwenden Sie die Abfrageparameter limit und offset für die Paginierung, um weitere Daten abzurufen. ### Angebotskette des aktuellen Nutzers anhand der ID abrufen - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/de/api/shop-builder/offer-chain-client/get-user-offer-chain-by-id.md): Ruft die Angebotskette des aktuellen Nutzers anhand der Angebotsketten-ID ab. ### Kostenlosen Angebotskettenschritt sichern - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/de/api/shop-builder/offer-chain-client/claim-user-offer-chain-step-reward.md): Schließt den aktuellen Fortschritt des Nutzers in der Angebotskette ab und gewährt die zugehörige Belohnung. Hinweis Verwenden Sie diesen Aufruf nur bei kostenlosen Schritten in der Angebotskette. Bei Schritten, die eine Zahlung in echter Währung erfordern, müssen Sie stattdessen den Aufruf Bestellung für kostenpflichtigen Angebotskettenschritt anlegen verwenden. ### Bestellung für kostenpflichtigen Angebotskettenschritt anlegen - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/de/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): Legt eine Bestellung für den Artikel an, der mit dem angegebenen kostenpflichtigen Angebotskettenschritt verknüpft ist. Der angelegten Bestellung wird der Status new zugewiesen. Öffnen Sie das Zahlungsportal in einem neuen Fenster mithilfe des folgenden Links: 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 Diese Methode muss clientseitig verwendet werden. Anhand der IP-Adresse des Nutzers wird das Land ermittelt und davon wiederum die Währung und die verfügbaren Zahlungsmethoden abgeleitet. Wird diese Methode serverseitig verwendet, wird mögliccherweise eine falsche Währung ermittelt, was sich wiederum auf die Zahlungsmethoden in Pay Station auswirkt. Hinweis Verwenden Sie diesen Aufruf nur bei kostenpflichtigen Schritten in der Angebotskette. Bei kostenlosen Schritten müssen Sie stattdessen den Aufruf Kostenlosen Angebotskettenschritt sichern verwenden. ## Zahlung (serverseitig) ### Zahlungstoken für den Kauf erstellen - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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. ## Webhooks ### Informationen zu Webhook-Einstellungen abrufen - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/common-regions/admin-update-region.md): Aktualisiert eine bestimmte Region. Anhand von Regionen können Sie regionale Beschränkungen verwalten. ## Katalog ### Spieleliste abrufen - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/game-keys-admin/admin-update-game-by-sku.md): Aktualisiert ein Spiel im Projekt anhand der SKU. ## Allgemeines ### Werbeaktion aktivieren - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/de/api/shop-builder/promotions-common/activate-promotion.md): Aktiviert eine Werbeaktion. ### Werbeaktion deaktivieren - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/de/api/shop-builder/promotions-common/deactivate-promotion.md): Deaktiviert eine Werbeaktion. ### Aktionscode überprüfen - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/de/api/shop-builder/promotions-common/verify-promotion-code.md): Prüft, ob es sich bei dem Code um einen Promocode oder einen Gutscheincode handelt und ob der Nutzer ihn anwenden kann. ### Liste aller Werbeaktionen abrufen - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/de/api/shop-builder/promotions-common/get-promotion-list.md): Ruft die Liste der Werbeaktionen eines Projekts ab. ### Werbeaktion anhand von einlösbarem Code abrufen - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/de/api/shop-builder/promotions-common/get-redeemable-promotion-by-code.md): Ruft die Werbeaktion anhand eines Promocodes oder Gutscheincodes ab. ## Gutscheine Mit dieser API können Sie Gutscheine verwalten. ### Limits eindeutiger Gutscheincodes abrufen - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupon-code-limit.md): Ruft ab, wie oft die Codes noch eingelöst werden dürfen. Verwenden Sie zum Filtern der Codes den Abfrageparameter codes. Im Abschnitt "Verwaltung" können Sie das Code-Limit selbst festlegen: * Gutscheine ### Gutscheinaktion aktivieren - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/activate-coupon.md): Aktiviert eine Gutscheinaktion. Die erstellte Gutscheinaktion ist standardmäßig deaktiviert. Gutscheine lassen sich erst einlösen, wenn Sie die zugehörige Werbeaktion aktivieren. Verwenden Sie diesen Endpunkt, um eine Gutscheinaktion zu aktivieren. ### Gutscheincodes abrufen - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupon-codes.md): Ruft Gutscheincodes ab. ### Gutscheincode erstellen - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/create-coupon-code.md): Erstellt einen Gutscheincode. ### Gutscheincodes generieren - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/generate-coupon-codes.md): Generiert Gutscheincodes. ### Gutscheinaktion deaktivieren - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/deactivate-coupon.md): Deaktiviert eine Gutscheinaktion. Die erstellte Gutscheinaktion ist standardmäßig deaktiviert. Gutscheine lassen sich erst einlösen, wenn Sie die zugehörige Werbeaktion aktivieren. Verwenden Sie diesen Endpunkt, um eine Gutscheinaktion zu deaktivieren. ### Gutschein-Limit für den angegebenen Benutzer abrufen - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupon-user-limit.md): Ruft ab, wie oft der angegebene Nutzer den Gutschein noch in Anspruch nehmen kann. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer einen Gutschein in Anspruch nehmen kann. Das Nutzerlimit können Sie im Abschnitt "Verwaltung" festlegen: * Gutscheine ### Gutscheinbelohnung abrufen - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupon-rewards-by-code.md): Ruft Gutscheinbelohnungen anhand des Codes ab. Dadurch können Nutzer aus mehreren Bonusartikeln wählen. Als Normalfall gilt die Wahl eines DRM-Systems, wenn der Gutschein ein Spiel als Bonus enthält (type=unit). ### Gutscheincode einlösen - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/redeem-coupon.md): Löst einen Gutscheincode ein. Der Nutzer erhält nach dem Einlösen eines Gutscheins einen Bonus. ### Liste der Gutscheinaktionen abrufen - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupons.md): Ruft die Liste der Gutscheinaktionen eines Projekts ab. ### Gutscheinaktionen erstellen - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/admin-create-coupon.md): Erstellt eine Gutscheinaktion. ### Gutscheinaktion löschen - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/delete-coupon-promotion.md): Löscht eine Gutscheinaktion. Die gelöschte Werbeaktion: * verschwindet aus der Liste der in Ihrem Projekt eingerichteten Werbeaktionen. * wird nicht mehr auf den Artikelkatalog angewendet. Nutzer können im Rahmen dieser Werbeaktion keine Bonusartikel erhalten. Nach der Löschung kann die Werbeaktion nicht wiederhergestellt werden. Gutscheincodes aus der gelöschten Werbeaktion können bestehenden Aktionen hinzugefügt werden. ### Gutscheinaktion abrufen - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/get-coupon.md): Ruft eine angegebene Gutscheinaktion ab. ### Gutscheinaktion aktualisieren - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-coupons/update-coupon-promotion.md): Aktualisiert eine Gutscheinaktion. ## Promocodes Diese API ermöglicht die Verwaltung von Promocodes. ### Promocode-Limit für Codes abrufen - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promo-code-code-limit.md): Ruft ab, wie oft die Codes noch eingelöst werden dürfen. Verwenden Sie zum Filtern der Codes den Abfrageparameter codes. Im Abschnitt "Verwaltung" können Sie das Code-Limit selbst festlegen: * Promocodes ### Promocode-Aktion aktivieren - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/activate-promo-code.md): Aktiviert eine Promocode-Aktion. Die erstellte Promocode-Aktion ist standardmäßig deaktiviert. Promocodes lassen sich erst einlösen, wenn Sie die zugehörige Werbeaktion aktivieren. Verwenden Sie diesen Endpunkt, um eine Promocode-Aktion zu aktivieren. ### Codes von Promocode-Aktion abrufen - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promocode-codes.md): Ruft Codes einer Promocode-Aktion ab. ### Code für Promocode-Aktion erstellen - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/create-promo-code-code.md): Erstellt Code für eine Promocode-Aktion. ### Codes für eine Promocode-Aktion generieren - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/generate-promo-code-codes.md): Generiert Codes für eine Promocode-Aktion. ### Promocode-Aktion deaktivieren - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/deactivate-promo-code.md): Deaktiviert eine Promocode-Aktion. Die erstellte Promocode-Aktion ist standardmäßig deaktiviert. Promocodes lassen sich erst einlösen, wenn Sie die zugehörige Werbeaktion aktivieren. Verwenden Sie diesen Endpunkt, um eine Promocode-Aktion zu deaktivieren. ### Promo-Code-Limit für den angegebenen Benutzer abrufen - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promo-code-user-limit.md): Ruft ab, wie oft der angegebene Nutzer den Promocode in Anspruch nehmen kann. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer einen Promocode in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung": * Promocodes ### Promocode-Belohnungen abrufen - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promo-code-rewards-by-code.md): Ruft Promocode-Belohnungen anhand des Codes ab. Dadurch können Nutzer aus mehreren Bonusartikeln wählen. Als Normalfall gilt die Wahl eines DRM-Systems, wenn der Promocode ein Spiel als Bonus enthält (type=unit). ### Promocode einlösen - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/redeem-promo-code.md): Löst einen Promocode aus einer Werbeaktion ein. Nach dem Einlösen eines Promocodes erhält der Nutzer kostenlose Artikel und/oder der Preis des Warenkorbs und/oder bestimmter Artikel wird reduziert. ### Promocode aus Warenkorb entfernen - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/remove-cart-promo-code.md): Entfernt einen Promocode aus einem Warenkorb. Nachdem der Promocode entfernt wurde, wird der Gesamtpreis aller Artikel im Warenkorb neu berechnet, ohne die durch einen Promocode sich ergebenden Boni und Rabatte. ### Liste der Promocode-Aktionen abrufen - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promo-codes.md): Ruft die Liste der Promocodes eines Projekts ab. ### Promocode-Aktion erstellen - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/create-promo-code.md): Erstellt eine Promocode-Aktion. ### Promocode löschen - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/delete-promo-code.md): Löscht eine Promocode-Aktion. Die gelöschte Werbeaktion: * verschwindet aus der Liste der in Ihrem Projekt eingerichteten Werbeaktionen. * wird nicht mehr auf den Artikelkatalog und den Warenkorb angewendet. Nutzer können im Rahmen dieser Werbeaktion keine Bonusartikel erhalten oder Artikel kaufen. Nach der Löschung kann die Werbeaktion nicht wiederhergestellt werden. Promocodes aus der gelöschten Aktion können bestehenden Aktionen hinzugefügt werden. ### Promocode-Aktion abrufen - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/get-promo-code.md): Ruft eine angegebene Promocode-Aktion ab. ### Promocode-Aktion aktualisieren - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-promo-codes/update-promo-code.md): Aktualisiert eine Promocode-Aktion. ## Katalogsonderangebote Mit dieser API können Sie Katalogsonderangebote verwalten. ### Katalogsonderangebot aktivieren - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Aktiviert ein Katalogsonderangebot. Das erstellte Katalogsonderangebot ist standardmäßig deaktiviert. Das Angebot kann erst eingelöst werden, nachdem Sie es aktiviert haben. Verwenden Sie diesen Endpunkt, um eine Gutscheinaktion freizuschalten und zu aktivieren. ### Codes für Katalogsonderangebote abrufen - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Ruft Codes für Katalogsonderangebote ab. ### Code für Katalogsonderangebote erstellen - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Erstellt einen Code für Katalogsonderangebote. ### Codes für Katalogsonderangebote generieren - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Generiert Codes für Katalogsonderangebote. ### Katalogsonderangebot deaktivieren - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Deaktiviert ein Katalogsonderangebot. Das erstellte Katalogsonderangebot ist standardmäßig deaktiviert. Das Angebot kann erst eingelöst werden, nachdem Sie es aktiviert haben. Verwenden Sie diesen Endpunkt, um eine Gutscheinaktion zu deaktivieren. ### Liste von Katalogsonderangeboten abrufen - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Ruft die Liste der Katalogsonderangebote eines Projekts ab. ### Katalogsonderangebot erstellen - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Erstellt ein Katalogsonderangebot. ### Katalogsonderangebotsaktion löschen - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Löscht eine einmalige Katalogsonderangebotsaktion. Die gelöschte Werbeaktion: * verschwindet aus der Liste der in Ihrem Projekt eingerichteten Werbeaktionen. * wird nicht mehr auf den Artikelkatalog und den Warenkorb angewendet. Der Nutzer können im Rahmen dieser Werbeaktion keine Artikel kaufen. Nach der Löschung kann die Werbeaktion nicht wiederhergestellt werden. ### Katalogsonderangebot abrufen - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Ruft das angegebene Katalogsonderangebot ab. ### Katalogsonderangebot aktualisieren - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/shop-builder/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Aktualisiert das Katalogsonderangebot. ## Rabatte Mit dieser API können Sie Rabattaktionen verwalten. ### Liste der Artikelaktionen abrufen - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/de/api/shop-builder/promotions-discounts/get-item-promotion-list.md): Ruft die Liste der Artikelaktionen eines Projekts ab. Werbeaktionen gewähren einen Rabatt (in %) auf Artikel. Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet. ### Rabattaktion für Artikel erstellen - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/de/api/shop-builder/promotions-discounts/create-item-promotion.md): Erstellt eine Rabattaktion für einen Artikel. Werbeaktionen gewähren einen Rabatt (in %) auf Artikel. Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet. ### Artikelaktion löschen - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/shop-builder/promotions-discounts/delete-item-promotion.md): Löscht eine Rabattaktion. Die gelöschte Aktion: * verschwindet aus der Liste der in Ihrem Projekt eingerichteten Werbeaktionen. * wird nicht mehr auf den Artikelkatalog und den Warenkorb angewendet. Nutzer können im Rahmen dieser Werbeaktion keine Artikel kaufen. Nach der Löschung kann die Werbeaktion nicht wiederhergestellt werden. ### Artikelaktion abrufen - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/shop-builder/promotions-discounts/get-item-promotion.md): Ruft die für einen bestimmten Artikel geltende Werbeaktion ab. Werbeaktionen gewähren einen Rabatt (in %) auf Artikel. Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet. ### Artikelaktion aktualisieren - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/shop-builder/promotions-discounts/update-item-promotion.md): Aktualisiert die Werbeaktion. HinweisNeue Daten ersetzen alte Daten. Auch wenn Sie nur einen Teil einer Werbeaktion aktualisieren möchten, sollten Sie alle erforderlichen Daten in der Anfrage übermitteln. Werbeaktionen gewähren einen Rabatt (in %) auf Artikel. Der Rabatt wird auf alle Preise der angegebenen Artikel angewendet. ## Boni Diese API ermöglicht die Verwaltung von Bonusaktionen. ### Liste der Bonusaktionen abrufen - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/de/api/shop-builder/promotions-bonuses/get-bonus-promotion-list.md): Ruft die Liste der Bonusaktionen eines Projekts ab. Die Werbeaktion gewährt dem Nutzer beim Kauf zusätzlich kostenlose Bonusartikel. Die Werbeaktion kann bei jedem Kauf innerhalb eines Projekts oder bei einem Kauf, der bestimmte Artikel umfasst, gelten. ### Bonusaktion erstellen - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/de/api/shop-builder/promotions-bonuses/create-bonus-promotion.md): Erstellt die Bonusaktion. Die Werbeaktion gewährt dem Nutzer beim Kauf zusätzlich kostenlose Bonusartikel. Die Werbeaktion kann bei jedem Kauf innerhalb eines Projekts oder bei einem Kauf, der bestimmte Artikel umfasst, gelten. ### Bonusaktion löschen - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/shop-builder/promotions-bonuses/delete-bonus-promotion.md): Löscht Bonusaktion. Die gelöschte Werbeaktion: * verschwindet aus der Liste der in Ihrem Projekt eingerichteten Werbeaktionen. * wird nicht mehr auf den Artikelkatalog und den Warenkorb angewendet. Nutzer können im Rahmen dieser Werbeaktion keine Bonusartikel erhalten. Nach der Löschung kann die Werbeaktion nicht wiederhergestellt werden. ### Bonusaktion abrufen - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/shop-builder/promotions-bonuses/get-bonus-promotion.md): Ruft die Bonusaktion ab. Die Werbeaktion gewährt dem Nutzer beim Kauf zusätzlich kostenlose Bonusartikel. Die Werbeaktion kann bei jedem Kauf innerhalb eines Projekts oder bei einem Kauf, der bestimmte Artikel umfasst, gelten. ### Bonusaktion aktualisieren - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/shop-builder/promotions-bonuses/update-bonus-promotion.md): Aktualisiert die Werbeaktion. HinweisNeue Daten ersetzen alte Daten. Auch wenn Sie nur einen Teil einer Werbeaktion aktualisieren möchten, sollten Sie alle erforderlichen Daten in der Anfrage übermitteln. Die Werbeaktion gewährt dem Nutzer beim Kauf zusätzlich kostenlose Bonusartikel. Die Werbeaktion kann bei jedem Kauf innerhalb eines Projekts oder bei einem Kauf, der bestimmte Artikel umfasst, gelten. ## Verwaltung ### Liste virtueller Währungen abrufen - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): Legt Bestellungen von mit virtueller Währung erworbenen Artikeln an. ## 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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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/shop-builder/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 ### Alle Werbeaktionslimits für den angegebenen Benutzer aktualisieren - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/reset-all-user-promotions-limit.md): Aktualisiert alle für den angegebenen Nutzer geltenden Werbeaktionslimits, sodass er diese Werbeaktionen wieder in Anspruch nehmen kann. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ### Werbeaktionslimit für angegebenen Benutzer herabsetzen - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/remove-user-promotion-limit.md): Verringert die Anzahl der verbleibenden Male, die der angegebene Nutzer eine Werbeaktion innerhalb des geltenden Limits in Anspruch nehmen darf. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Bereich "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ### Werbeaktionslimit für angegebenen Benutzer abrufen - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/get-user-promotion-limit.md): Ruft ab, wie oft die der angegebene Nutzer die Werbeaktion innerhalb des geltenden Limits noch in Anspruch nehmen darf. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Bereich "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ### Werbeaktionslimit für angegebenen Benutzer erhöhen - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/add-user-promotion-limit.md): Erhöht die Anzahl der verbleibenden Male, die der angegebene Nutzer die Werbeaktion innerhalb des geltenden Limits in Anspruch nehmen darf. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Bereich "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ### Werbeaktionslimit für angegebenen Benutzer festlegen - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/set-user-promotion-limit.md): Legt fest, wie oft der angegebene Nutzer eine Werbeaktion innerhalb des geltenden Limits in Anspruch nehmen darf, nachdem das Limit erhöht oder herabgesetzt wurde. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ### Werbeaktionslimit für Benutzer aktualisieren - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/de/api/shop-builder/user-limits-admin/reset-user-promotion-limit.md): Aktualisiert das Werbaaktionslimit, damit ein Nutzer diese Aktion erneut in Anspruch nehmen kann. Ist dem Parameter user der Wert null zugewiesen, wird das Limit für alle Nutzer aktualisiert. Mit der entsprechenden API (User limit API) können Sie begrenzen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen kann. Um das Nutzerlimit zu konfigurieren, wechseln Sie zum Abschnitt "Verwaltung" der gewünschten Werbeaktionsart: * Rabattaktionen * Bonusaktionen ## Verwaltung ### Liste der Wertpunkte abrufen - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-get-value-points-list.md): Ruft die Liste der Wertpunkte innerhalb eines Projekts zu Verwaltungszwecken ab. ### Wertpunkt erstellen - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-create-value-points.md): Erstellt einen Wertpunkt. ### Wertpunkte löschen - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-delete-value-point.md): Löscht einen durch Angabe der SKU festgelegten Wertpunkt. ### Wertpunkt abrufen - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-get-value-point.md): Ruft einen durch Angabe der SKU festgelegten Wertpunkt innerhalb eines Projekts zu Verwaltungszwecken ab. ### Wertpunkt aktualisieren - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-update-value-point.md): Aktualisiert einen durch Angabe der SKU festgelegten Wertpunkt. ### Wertpunkte von Artikeln löschen - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Entfernt Wertpunktbelohnungen von ALLEN Artikeln. ### Liste der Artikel mit Wertpunkten abrufen - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Ruft eine Liste aller Artikel mit Wertpunkten innerhalb eines Projekts zu Verwaltungszwecken ab. ### Wertpunkte für Artikel teilweise aktualisieren - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Aktualisiert die Anzahl der Wertpunkte für einen oder mehrere Artikel teilweise anhand der SKU des Artikels. Nutzer erhalten Wertpunkte nach dem Kauf der angegebenen Artikel. Grundregeln für die Aktualisierung von Wertpunkten: * Wenn einem Artikel noch keine Wertpunkte zugewiesen sind, werden diese durch das Senden eines Wertes ungleich Null in das Feld amount eingetragen. * Wenn einem Artikel bereits Wertpunkte zugewiesen sind, werden die im Feld amount angegebenen Wertpunkte durch das Senden eines Wertes ungleich Null überschrieben. * Wennamount auf 0 festgelgt wird, werden die vorhandenen Wertpunkte für diesen Artikel gelöscht. Im Gegensatz zur PUT-Methode (Wertpunkte für Artikel festlegen), werden bei dieser PATCH-Methode nicht alle vorhandenen Artikel-Wertpunkte im Projekt überschrieben, sondern nur die Wertpunkte der angegebenen Artikel aktualisiert. Mit einer einzelnen Anfrage können bis zu 100 Artikel aktualisiert werden. Doppelt vorhandene Artikel-SKUs dürfen nicht in derselben Anfrage enthalten sein. ### Wertpunkte für Artikel festlegen - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Weist einem oder mehreren Artikeln durch Angabe der entsprechenden SKU Wertpunkte zu. Nutzer erhalten Wertpunkte, nachdem sie diese Artikel gekauft haben. Beachten Sie, dass diese PUT-Anfrage alle zuvor festgelegten Wertpunkte für Artikel im Projekt überschreibt. Um ein unbeabsichtigtes Löschen von Wertpunkten zu vermeiden, müssen alle Artikel und ihre jeweiligen Wertpunkte in jeder PUT-Anfrage angegeben sein. Wenn Sie nur die Wertpunkte für einen bestimmten Artikel aktualisieren und die Wertpunkte anderer Artikel unverändert lassen möchten, sollten Sie den aktuellen Satz Wertpunkte mithilfe einer GET-Anfrage abrufen, die Wertpunkte des gewünschten Artikels ändern und dann den geänderten Satz mit den aktualisierten Wertpunkten für den entsprechenden Artikel zurücksenden. ### Liste der Belohnungsketten abrufen - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chains.md): Ruft die Liste der Belohnungsketten 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 10 Artikel pro Antwort. Um pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset. ### Belohnungskette erstellen - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-create-reward-chain.md): Erstellt eine Belohnungskette. ### Belohnungskette löschen - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-delete-reward-chain.md): Löscht eine bestimmte Belohnungskette. ### Belohnungskette abrufen - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chain.md): Ruft eine bestimmte Belohnungskette ab. ### Belohnungskette aktualisieren - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-update-reward-chain.md): Aktualisiert eine bestimmte Belohnungskette. ### Belohnungskette zurücksetzen - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-reset-reward-chain.md): Setzt die Wertpunkte und den Fortschritt aller Nutzer in der Belohnungskette zurück. Nach dem Zurücksetzen können Sie den Gültigkeitszeitraum der Belohnungskette aktualisieren und der Nutzer kann sie erneut durchlaufen. Hinweis Sie sollten die Belohnungskette während ihrer Gültigkeitsdauer nicht zurücksetzen, weil die Nutzer ansonsten verdiente Wertpunkte möglicherweise verlieren, bevor sie ihre Belohnung in Anspruch nehmen können. ### Belohnungskette aktivieren/deaktivieren - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/de/api/shop-builder/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Aktiviert/deaktiviert die Belohnungskette. ## Client ### Belohnungsketten des aktuellen Nutzers abrufen - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/de/api/shop-builder/reward-chain-client/get-reward-chains-list.md): Client-Endpunkt. Ruft die Belohnungsketten des aktuellen Nutzers 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 pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset. ### Wertpunktestand des aktuellen Nutzers abrufen - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/de/api/shop-builder/reward-chain-client/get-user-reward-chain-balance.md): Client-Endpunkt. Ruft den Wertpunktestand des aktuellen Nutzers ab. ### Schrittbelohnung gewähren - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/de/api/shop-builder/reward-chain-client/claim-user-reward-chain-step-reward.md): Client-Endpunkt. Gewährt dem aktuellen Nutzer die Schrittbelohnung aus einer Belohnungskette. ## Clans-Client ### Top-10-Liste der Personen abrufen, die am meisten zur Clan-Belohnungskette beigetragen haben - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/de/api/shop-builder/clan-reward-chain-client/get-user-clan-top-contributors.md): Ruft die Top-10-Liste der Personen ab, die am meisten zur angegebenen Belohnungskette des Clans des aktuellen Nutzers beigetragen haben. Wenn ein Nutzer keinem Clan angehört, gibt der Aufruf ein leeres Array zurück. ### Den Clan des aktuellen Nutzers aktualisieren - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/de/api/shop-builder/clan-reward-chain-client/user-clan-update.md): Aktualisiert den Clan eines aktuellen Nutzers über Benutzerattribute. Sichert alle Belohnungen aus Belohnungsketten, solange diese nicht für einen vorherigen Clan gesichert wurden, und gibt sie in der Antwort zurück. Wenn der Nutzer früher einem Clan angehörte und jetzt nicht mehr, wird seine Zugehörigkeit zu diesem Clan widerrufen. Wenn der Nutzer den Clan gewechselt hat, wird der Clan geändert. ## Verwaltung ### Liste der Angebotsketten abrufen - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-get-offer-chains.md): Ruft eine Liste der Angebotsketten zur Verwaltung ab. HinweisIn allen Projekten ist die Anzahl der Artikel, die in einer einzigen Antwort zurückgegeben werden können, begrenzt. Der Standard- und Maximalwert beträgt 10 Artikel pro Antwort. Verwenden Sie die Abfrageparameter limit und offset für die Paginierung, um weitere Daten abzurufen. ### Angebotskette erstellen - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-create-offer-chain.md): Erstellt eine Angebotskette. ### Angebotskette löschen - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-delete-offer-chain.md): Löscht eine bestimmte Angebotskette. Nach dem Löschen: verbleiben alle bereits von den Nutzern erhaltenen Belohnungen in deren Besitz.sind unvollendete Schritte nicht mehr verfügbar und zugehörige Belohnungen können nicht mehr erhalten werden. Im Gegensatz zur Deaktivierung der Angebotskette über den Aufruf Angebotskette aktivieren/deaktivieren, ist die Löschung ist unumkehrbar und der Nutzerfortschritt wird nicht gespeichert. ### Angebotskette abrufen - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-get-offer-chain.md): Ruft eine bestimmte Angebotskette zur Verwaltung ab. ### Angebotskette aktualisieren - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-update-offer-chain.md): Aktualisiert eine bestimmte Angebotskette. ### Angebotskette aktivieren/deaktivieren - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/de/api/shop-builder/offer-chain-admin/admin-toggle-offer-chain.md): Aktiviert oder deaktiviert eine Angebotskette. Wenn die Angebotskette deaktiviert ist, verlieren Nutzer vorübergehend den Zugriff darauf, ihr Fortschritt bleibt jedoch erhalten. Nachdem die Angebotskette erneut aktiviert wurde, können Nutzer an der Stelle fortfahren, an der sie aufgehört haben. ## Verwaltung ### Liste der täglichen Belohnungen abrufen - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-get-daily-chains.md): Ruft eine Liste der täglichen Belohnungen zur Verwaltung ab. HinweisDie Methode gibt eine paginierte Artikelliste zurück. Der Maximal- und Standardwert beträgt 50 Artikel pro Antwort. Verwenden Sie die Parameter limit und offset, um weitere Seiten bzw. Artikel aus der Liste abzurufen. Wenn Sie beispielsweise die Methode mit den Parameterwerten "limit = 25" und "offset = 100" aufrufen, sind in der Antwort 25 Artikel aufgeführt, beginnend mit dem 101. Artikel in der Gesamtliste. ### Tägliche Belohnung erstellen - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-create-daily-chain.md): Erstellt eine tägliche Belohnung ### Tägliche Belohnung löschen - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-delete-daily-chain.md): Löscht eine bestimmte tägliche Belohnung. ### Tägliche Belohnung abrufen - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-get-daily-chain.md): Ruft eine bestimmte tägliche Belohnung zur Verwaltung ab. ### Tägliche Belohnung aktualisieren - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-update-daily-chain.md): Aktualisiert eine bestimmte tägliche Belohnung. ### Tägliche Belohnung zurücksetzen - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-reset-daily-chain.md): Setzt den Fortschritt aller Nutzer bei der täglichen Belohnung zurück. Gilt nur für tägliche Belohnungen vom Typ rolling. ### Tägliche Belohnung aktivieren/deaktivieren - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/de/api/shop-builder/daily-chain-admin/admin-toggle-daily-chain.md): Aktiviert oder deaktiviert eine tägliche Belohnung. ## Client ### Tägliche Belohnungen des aktuellen Nutzers abrufen - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/de/api/shop-builder/daily-chain-client/get-daily-chains-list.md): Client-Endpunkt. Ruft die täglichen Belohnungen des aktuellen Nutzers ab. HinweisDie Methode gibt eine paginierte Artikelliste zurück. Der Maximal- und Standardwert beträgt 50 Artikel pro Antwort. Verwenden Sie die Parameter limit und offset, um weitere Seiten bzw. Artikel aus der Liste abzurufen. Wenn Sie beispielsweise die Methode mit den Parameterwerten "limit = 25" und "offset = 100" aufrufen, sind in der Antwort 25 Artikel aufgeführt, beginnend mit dem 101. Artikel in der Gesamtliste. ### Tägliche Belohnung des aktuellen Nutzers anhand der Belohnungs-ID abrufen - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/de/api/shop-builder/daily-chain-client/get-user-daily-chain-by-id.md): Client-Endpunkt. Ruft die tägliche Belohnung des aktuellen Nutzers anhand der Belohnungs-ID ab. ### Täglichen Belohnungsschritt beanspruchen - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/de/api/shop-builder/daily-chain-client/claim-user-daily-chain-step-reward.md): Client-Endpunkt. Beansprucht die Schrittbelohnung aus einer täglichen Belohnung für den aktuellen Nutzer. Alle Schritte können nur in fortlaufender Reihenfolge beansprucht werden. Die Belohnung für einen verpassten Schritt kann nicht gegen virtuelle oder reale Währung oder durch das Ansehen einer Werbeanzeige erlangt werden. ## Verwaltung ### Informationen zum Upselling im Projekt abrufen - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/de/api/shop-builder/upsell-admin/get-upsell-configurations-for-project-admin.md): Ruft die Informationen zum Upselling im Projekt ab: ob es aktiviert ist, die Art des Upsellings und die SKU-Liste der Artikel, die Teil dieses Upsellings sind. ### Upselling erstellen - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/de/api/shop-builder/upsell-admin/post-upsell.md): Erstellt Upselling für ein Projekt. ### Upselling aktualisieren - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/de/api/shop-builder/upsell-admin/put-upsell.md): Aktualisieren Sie Upselling für ein Projekt. ### Upselling-Artikel des Projekts aktivieren/deaktivieren - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/de/api/shop-builder/upsell-admin/put-upsell-toggle-active-inactive.md): Ändert den Status von Upselling-Artikeln in einem Projekt auf „aktiv“ oder „inaktiv“. ## Client ### Liste der Upselling-Artikel im Projekt abrufen - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/de/api/shop-builder/upsell-client/get-upsell-for-project-client.md): Ruft eine Liste der Upselling-Artikel in einem Projekt ab, wenn diese bereits eingerichtet wurden. ## Verwaltung ### Status des Artikelimports abrufen - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/de/api/shop-builder/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/shop-builder/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.