# Digital Distribution Hub # Überblick Der Digital Distribution Hub ist eine neue Lösung von Xsolla, mit der sich digitale und bargeldbasierte Zahlungen über Push-Payment-Technologie und E-Commerce verknüpfen lassen. Diese Referenz enthält API-Endpunkte für zwei Xsolla-Produkte: [Ingame-Online-Shop](https://developers.xsolla.com\/de/doc/in-game-store/) und [Bezahlstation](https://developers.xsolla.com\/de/doc/pay-station/). Es gibt zwei grundlegende URLs: * `https://store.xsolla.com/api` für die Gruppen **Allgemeines**, **Katalog**, **Warenkorb** und **Bestellung**. * `https://ps.xsolla.com` für die Gruppe **Benachrichtigungen**. API-Endpunkte in der Gruppe **Katalog** erfordern keine Autorisierung. Um Aufrufe aus den Gruppen **Warenkorb** und **Bestellung** nutzen zu können, müssen Sie einen Token mithilfe der Methode [Benutzertoken erstellen](https://developers.xsolla.com\/de/digital-distribution-hub/common/user-token/create-user-token) generieren.
Hinweis:

Diese Referenz beschreibt eine im Entwurfsstadium befindliche zukünftige API, die Schnittstelle ist noch nicht voll funktionsfähig. Derzeit können Sie nur die Endpunkte der Gruppen Katalog und Benachrichtigungen ausprobieren. Feedback können Sie gerne per E-Mail an techdoc@xsolla.com senden.
Version: 1.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForClient Verwenden Sie den Endpunkt [Benutzertoken erstellen](https://developers.xsolla.com\/de/api/digital-distribution-hub/operation/create-user-token), um einen Token zu generieren. Type: http Scheme: bearer ### basicAuth Die Xsolla-API verwendet die Basisauthentifizierung. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` dem `distribution_hub_id:api_key`-Paar entspricht, das gemäß dem Base64-Standard codiert ist. Ihr Account Manager kann Ihnen auf Anfrage die `distribution_hub_id` und den `api_key` mitteilen. Type: http Scheme: basic ## Download OpenAPI description [Digital Distribution Hub](https://developers.xsolla.com/_bundle/@l10n/de/api/digital-distribution-hub/index.yaml) ## Warenkorb ### Warenkorb des aktuellen Benutzers abrufen - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/get-user-cart.md): Gibt den Warenkorb des aktuellen Benutzers zurück. ### Alle Warenkorbartikel aus dem aktuellen Warenkorb löschen - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/cart-clear.md): Löscht alle Artikel aus dem Warenkorb. ### Artikel in den Warenkorb legen - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/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 übermittelten Wert ersetzt. ### Warenkorbartikel aus aktuellem Warenkorb löschen - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/delete-item.md): Entfernt einen Artikel aus dem Warenkorb. ### Warenkorbartikel aus aktuellem Warenkorb aktualisieren - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/put-item.md): Aktualisiert einen bestehenden Warenkorbartikel oder erstellt den Artikel im Warenkorb. ### Warenkorb anhand von Warenkorb-ID abrufen - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/get-cart-by-id.md): Gibt den Warenkorb des Benutzers anhand der Warenkorb-ID zurück. ### Alle Warenkorbartikel anhand von Warenkorb-ID löschen - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/cart-clear-by-id.md): Löscht alle Artikel aus dem Warenkorb. ### Spezifischen Artikel in den Warenkorb legen - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/cart-fill-by-id.md): Legt spezifischen Artikel in den Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird die vorhandene Artikelposition durch den übermittelten Wert ersetzt. ### Warenkorbartikel anhand von Warenkorb-ID löschen - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/delete-item-by-cart-id.md): Entfernt einen Artikel aus dem Warenkorb. ### Warenkorbartikel anhand von Warenkorb-ID aktualisieren - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/cart/put-item-by-cart-id.md): Aktualisiert einen bestehenden Warenkorbartikel oder erstellt den Artikel im Warenkorb. ## Spielschlüssel ### Spieleliste abrufen - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-games-list.md): Ruft eine Spieleliste zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### DRM-Liste abrufen - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-drm-list.md): Ruft die Liste der verfügbaren DRMs ab. ### Spieleliste anhand von angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-games-group.md): Ruft eine Spieleliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### Liste der Spiele auf einer Plattform anhand von angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-game-keys-group.md): Ruft eine Liste von Spielen auf einer Plattform aus der angegebenen Gruppe zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### Spiel für den Katalog abrufen - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-game-key-by-sku.md): Ruft ein Spiel für den Katalog ab. ### Spiel für den Katalog abrufen - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/game-keys/get-game-by-sku.md): Ruft ein Spiel für den Katalog ab. ## Virtuelle Gegenstände und Währung ### Liste von Artikelgruppen abrufen - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/de/api/digital-distribution-hub/virtual-items-and-currency/get-item-groups.md): Ruft eine Liste von Artikelgruppen zum Erstellen eines Katalogs ab. ### Liste der virtuellen Währungen abrufen - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/de/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency.md): Ruft eine Liste von virtuellen Währungen zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### Liste der virtuellen Währungspakete abrufen - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/de/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-currency-package.md): Ruft eine Liste von virtuellen Währungspaketen zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### Liste der virtuellen Gegenstände abrufen - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/de/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items.md): Ruft eine Liste von virtuellen Gegenständen zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ### Artikelliste anhand von angegebener Gruppe abrufen - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/virtual-items-and-currency/get-virtual-items-group.md): Ruft eine Artikelliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen. ## Bundles ### Liste der Bundle abrufen - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/de/api/digital-distribution-hub/bundles/get-bundle-list.md): Ruft eine Liste von Bundles zum Erstellen eines Katalogs ab. Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. ### Angegebenes Bundle abrufen - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/bundles/get-bundle.md): Ruft ein angegebenes Bundle ab. ## Benutzertoken ### Benutzertoken erstellen - [POST /v2/project/{project_id}/distribution_hub/user/auth](https://developers.xsolla.com/de/api/digital-distribution-hub/user-token/create-user-token.md): Überprüft, ob ein Benutzer im Spiel existiert, und erstellt ein Benutzertoken. ## Benachrichtigungen ### Benachrichtigung abbrechen - [POST /push-payments/cancel](https://developers.xsolla.com/de/api/digital-distribution-hub/notifications/cancel-notification.md): Senden Sie die Benachrichtigung über die Zahlungsstornierung, wenn: - die Zahlung nicht abgeschlossen wurde - die Zahlung erstattet wurde ### Zahlungsbenachrichtigung - [POST /push-payments/pay](https://developers.xsolla.com/de/api/digital-distribution-hub/notifications/pay-notification.md): Senden Sie diese Benachrichtigung nach erfolgreicher Abbuchung vom Konto eines Benutzers. ## Bestellung ### Bestellung abrufen - [GET /v2/project/{project_id}/distribution_hub/order/{order_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/order/get-order.md): Ruft eine angegebene Bestellung ab. ### Bestellung mit allen Artikeln aus dem aktuellen Warenkorb erstellen - [POST /v2/project/{project_id}/distribution_hub/payment/cart](https://developers.xsolla.com/de/api/digital-distribution-hub/order/create-order.md): Erstellt eine Bestellung mit allen Artikeln aus dem Warenkorb. Der erstellten Bestellung wird der Bestellstatus new zugewiesen. ### Bestellung mit allen Artikeln aus einem bestimmten Warenkorb erstellen - [POST /v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}](https://developers.xsolla.com/de/api/digital-distribution-hub/order/create-order-by-cart-id.md): Erstellt eine Bestellung mit allen Artikeln aus dem entsprechenden Warenkorb. Der erstellten Bestellung wird der Bestellstatus new zugewiesen. ### Bestellung mit dem angegebenen Artikel erstellen - [POST /v2/project/{project_id}/distribution_hub/payment/item/{item_sku}](https://developers.xsolla.com/de/api/digital-distribution-hub/order/create-order-with-item.md): Erstellt eine Bestellung mit einem angegebenen Artikel. Der erstellten Bestellung wird der Bestellstatus new zugewiesen.