` der Benutzertoken ist. Der Token dient dazu, den Nutzer zu identifizieren und ihm Zugriff auf personalisierte Daten zu ermöglichen.
Alternativ können Sie einen [Token zum Öffnen des Zahlungsportals](/de/api/pay-station/token/create-token) verwenden.
2. **Vereinfachter Modus ohne Autorisierungs-Header.** Dieser Modus ist nur für nicht autorisierte Nutzer vorgesehen und kann lediglich für den [Verkauf von Spielschlüsseln](/de/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users) genutzt werden. Anstelle eines Tokens muss die Anfrage die folgenden Header enthalten:
- `x-unauthorized-id` samt Anfrage-ID
- `x-user` samt der E-Mail-Adresse des Nutzers, kodiert in Base64
## Nützliche Links
- [API-Aufrufe nach Interaktionsmodell](https://developers.xsolla.com/de/api/catalog/)
- [Endpunkttypen](https://developers.xsolla.com/de/api/catalog/)
- [Fehlerbehandlung](https://developers.xsolla.com/de/api/catalog/)
- [API-Schlüssel](https://developers.xsolla.com/de/api/catalog/)
# Grundstruktur der Entität
Alle Artikeltypen (virtuelle Gegenstände, Bundles, virtuelle Währung und Schlüssel) haben eine ähnliche Datenstruktur. Kenntnisse über die Grundstruktur vereinfachen die Arbeit mit der API und erleichtern das Navigieren in der Dokumentation.
Hinweis
Einige Aufrufe können zusätzliche Felder enthalten, doch diese ändern nichts an der Grundstruktur.
**Identifikation**
- `merchant_id` – Firmen-ID im [Kundenportal](https://publisher.xsolla.com/)
- `project_id` – Projekt-ID im Kundenportal
- `sku` – Artikel-SKU, einzigartig innerhalb des Projekts
**Shop-Anzeige**
- `name` – Artikelname
- `description` – Artikelbeschreibung
- `image_url` – Bild-URL
- `is_enabled` – Artikelverfügbarkeit
- `is_show_in_store` – ob der Artikel im Katalog angezeigt wird
Weitere Informationen zur Verwaltung der Artikelverfügbarkeit im Katalog finden Sie in der [Dokumentation](/de/items-catalog/catalog-features/items-availability/).
**Organisation**
- `type` – Artikeltyp, zum Beispiel ein virtueller Gegenstand (`virtual_item`) oder Bundle (`bundle`)
- `groups` – Gruppen, zu denen der Artikel gehört
- `order` – Anzeigereihenfolge im Katalog
**Verkaufsbedingungen**
- `prices` – Preise in echter oder virtueller Währung
- `limits` – Kauflimits
- `periods` – Verfügbarkeitszeiträume
- `regions` – regionale Beschränkungen
**Grundstruktur einer Entität (Beispiel):**
```json
{
"attributes": [],
"bundle_type": "virtual_currency_package",
"content": [
{
"description": {
"en": "Main in-game currency"
},
"image_url": "https://.../image.png",
"name": {
"en": "Crystals",
"de": "Kristalle"
},
"quantity": 500,
"sku": "com.xsolla.crystal_2",
"type": "virtual_currency"
}
],
"description": {
"en": "Crystals x500"
},
"groups": [],
"image_url": "https://.../image.png",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {
"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"long_description": null,
"media_list": [],
"name": {
"en": "Medium crystal pack"
},
"order": 1,
"periods": [
{
"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [
{
"amount": 20,
"country_iso": "US",
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [],
"sku": "com.xsolla.crystal_pack_2",
"type": "bundle",
"vc_prices": []
}
```
# Grundlegender Kaufablauf
Über die Xsolla-API lässt sich die Logik für einen Ingame-Shop implementieren, darunter das Abrufen des Artikelkatalogs, die Verwaltung des Warenkorbs, das Anlegen von Bestellungen und die Verfolgung des Bestellstatus. Je nach Integrationsszenario sind die API-Aufrufe in die Unterbereiche **Verwaltung** und **Katalog** unterteilt, die unterschiedliche [Authentifizierungsschemen](/de/api/catalog/section/authentication) verwenden.
Das folgende Beispiel zeigt den grundlegenden Ablauf für die Einrichtung und den Betrieb eines Shops, von der Artikelerstellung bis zum Kauf.
## Artikel und Gruppen erstellen (Verwaltung)
Erstellen Sie für Ihren Shop einen Katalog mit Artikeln wie etwa virtuellen Gegenständen, Bundles oder virtueller Währung.
API-Aufrufe (Beispiele):
- [Virtuellen Gegenstand erstellen](/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-item)
- [Bundle erstellen](/de/api/catalog/bundles-admin/admin-create-bundle)
- [Virtuelle Währung erstellen](/de/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency)
## Werbeaktionen, Ketten und Limits einrichten (Verwaltung)
Konfigurieren Sie Tools für die Nutzergewinnung und Monetarisierung, wie etwa Rabatte, Boni, tägliche Belohnungen oder Angebotsketten.
API-Aufrufe (Beispiele):
- [Bonusaktion erstellen](/de/api/liveops/promotions-bonuses/create-bonus-promotion)
- [Tägliche Belohnung erstellen](/de/api/liveops/daily-chain-admin/admin-create-daily-chain)
- [Katalogsonderangebot erstellen](/de/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer)
## Artikelinformationen abrufen (Client)
Konfigurieren Sie, wie Artikel in Ihrer Anwendung angezeigt werden sollen.
Hinweis
Verwenden Sie keine API-Aufrufe aus dem Unterabschnitt "Verwaltung", um einen Nutzerkatalog zu erstellen. Diese API-Aufrufe unterliegen
Ratenbegrenzungen und sind nicht für Nutzer-Traffic vorgesehen.
API-Aufrufe (Beispiele):
- [Liste virtueller Gegenstände abrufen](/de/api/catalog/virtual-items-currency-catalog/get-virtual-items)
- [Liste der Artikelgruppen abrufen](/de/api/catalog/virtual-items-currency-catalog/get-item-groups)
- [Liste der Bundles abrufen](/de/api/catalog/bundles-catalog/get-bundle-list)
- [Liste der verkäuflichen Artikel abrufen](/de/api/catalog/common-catalog/get-sellable-items)
Hinweis
Standardmäßig geben katalogbezogene API-Aufrufe Artikel zurück, die zum Zeitpunkt der Anfrage im Shop verfügbar sind. Um Artikel abzurufen, die noch nicht verfügbar oder nicht mehr verfügbar sind, müssen Sie den Parameter "show_inactive_time_limited_items": 1 in der Kataloganfrage ergänzen.
## Artikel verkaufen
Artikel können Sie mit den folgenden Methoden verkaufen:
- Schnellkauf – Verkauf einer einzelnen SKU in beliebiger Menge.
- Warenkorbkauf – der Nutzer kann im Rahmen einer Bestellung Artikel in den Warenkorb legen, Artikel aus dem Warenkorb entfernen und die Menge jedes einzelnen Artikels ändern.
Wird ein Artikel mit virtueller Währung anstelle von echtem Geld gekauft, müssen Sie den API-Aufruf [Bestellung mit einem angegebenen, in virtueller Währung gekauften Artikel anlegen](/de/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency) verwenden. Das Zahlungsportal muss nicht aufgerufen werden, da die Zahlungsabwicklung bei Ausführung des API-Aufrufs erfolgt.
Beim Kauf eines kostenlosen Artikels müssen Sie den API-Aufruf [Bestellung mit angegebenem kostenlosen Artikel anlegen](/de/api/catalog/free-item/create-free-order-with-item) oder den API-Aufruf [Bestellung mit einem kostenlosen Warenkorb anlegen](/de/api/catalog/free-item/create-free-order) verwenden. as Zahlungsportal muss nicht aufgerufen werden – der Bestellung wird sofort der Status done zugewiesen.
### Schnellkauf
Verwenden Sie den clientseitigen API-Aufruf, um [eine Bestellung mit einem angegebenen Artikel anzulegen](/de/api/catalog/payment-client-side/create-order-with-item). Der Aufruf gibt einen Token zurück, mit dem sich das Zahlungsportal öffnen lässt.
Hinweis
Rabattinformationen sind für den Nutzer nur im Zahlungsportal verfügbar. Promocodes werden nicht unterstützt.
### Warenkorbkauf
Die Einrichtung des Warenkorbs und der Kaufvorgang können sowohl client- als auch serverseitg erfolgen.
**Warenkorb clientseitig einrichten und Artikel kaufen**
Implementieren Sie die Logik für das Hinzufügen und Entfernen von Artikeln selbst. Bevor Sie die API zum Einrichten eines Warenkorbs aufrufen, liegen Ihnen keine Informationen darüber vor, welche Werbeaktionen auf den Kauf angewendet werden. Die Gesamtkosten und die Details der hinzugefügten Bonusartikel sind Ihnen also unbekannt.
Implementieren Sie die folgende Warenkorblogik:
1. Verwenden Sie den API-Aufruf [Artikel in den Warenkorb legen](/de/api/shop-builder/operation/cart-fill/), nachdem der Spieler einen Warenkorb zusammengestellt hat. Der Aufruf gibt die aktuellen Informationen zu den ausgewählten Artikeln zurück (Preise mit und ohne Rabatt, Bonusartikel).
2. Aktualisieren Sie den Warenkorbinhalt basierend auf den Aktionen des Nutzers:
- Verwenden Sie den API-Aufruf [Warenkorbartikel anhand von Warenkorb-ID aktualisieren](/de/api/shop-builder/operation/put-item-by-cart-id/), um einen Artikel in den Warenkorb zu legen oder die Artikelmenge zu ändern.
- Verwenden Sie den API-Aufruf [Warenkorbartikel anhand von Warenkorb-ID löschen](/de/api/shop-builder/operation/delete-item-by-cart-id/), um einen Artikel zu entfernen.
Hinweis
Mit dem API-Aufruf "Warenkorb des aktuellen Benutzers abrufen" können Sie den aktuellen Status des Warenkorbs abrufen.
3. Verwenden Sie den API-Aufruf [Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen](/de/api/shop-builder/operation/create-order/). Der Aufruf gibt die Bestell-ID und den Zahlungstoken zurück. Der neu angelegten Bestellung wird standardmäßig der Status new zugewiesen.
**Warenkorb serverseitig einrichten und Artikel kaufen**
Diese Einrichtungsoption kann länger dauern, da jede Änderung am Warenkorb durch API-Aufrufe vorgenommen werden muss.
Implementieren Sie die folgende Warenkorblogik:
1. Verwenden Sie den API-Aufruf [Artikel in den Warenkorb legen](/de/api/catalog/cart-server-side), nachdem der Spieler einen Warenkorb zusammengestellt hat. Der Aufruf gibt die aktuellen Informationen zu den ausgewählten Artikeln zurück (Preise mit und ohne Rabatt, Bonusartikel).
2. Verwenden Sie den API-Aufruf [Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen](/de/api/shop-builder/operation/create-order/). Der Aufruf gibt die Bestell-ID und den Zahlungstoken zurück. Der neu angelegten Bestellung wird standardmäßig der Status new zugewiesen.
## Zahlungsportal öffnen
Verwenden Sie den zurückgegebenen Token, um das Zahlungsportal in einem neuen Fenster zu öffnen. Weitere Möglichkeiten, das Zahlungsportal zu öffnen, sind in der [Dokumentation](/de/payment-ui-and-flow/payment-ui/how-to-open-payment-ui/#open_payment_ui) beschrieben.
| Aktion | Endpunkt |
|:--------------------------------|:--------------------------------------------------------------------------|
| In der Produktionsumgebung öffnen. | https://secure.xsolla.com/paystation4/?token={token} |
| In der Testumgebung öffnen. | https://sandbox-secure.xsolla.com/paystation4/?token={token} |
Hinweis
Nutzen Sie die Testumgebung während der Entwicklung und zum Testen. Es stehenn
Test-Bankkarten bereit. Bei Testkäufen wird kein Geld von echten Konten abgebucht.
Sobald die erste tatsächliche Zahlung erfolgt ist, tritt eine strenge Zahlungsrichtlinie für die Testumgebung in Kraft: Ab dann dürfen nur noch die unter [Kundenportal > Firmeneinstellungen > Nutzer](https://publisher.xsolla.com/0/settings/users) angegebenen Nutzer ein Zahlung in der Testumgebung tätigen .
Der Kauf von virtueller Währung und Gegenständen gegen echtes Geld ist erst nach Unterzeichnung einer Lizenzvereinbarung möglich. Navigieren Sie dazu im [Kundenportal](https://publisher.xsolla.com/) zu **Vereinbarungen und Steuern > Vereinbarungen**, füllen Sie das Formular aus, und warten Sie auf die Bestätigung. Die Prüfung kann bis zu drei Werktage dauern.
Die Testumgebung können Sie aktivieren oder deaktivieren. Ändern Sie dazu einfach den Wert des Parameters `sandbox` in der Schnellkauf- bzw. Warenkorbkauf-Anfrage. Die Testumgebung ist standardmäßig deaktiviert.
Mögliche Bestellstatus:
- `new` – Bestellung angelegt
- `paid` – Zahlung erhalten
- `done` – Artikel geliefert
- `canceled` – Bestellung storniert
- `expired` – Bestellung abgelaufen
Tracken Sie den Bestellstatus mit einer der folgenden Methoden:
- [mit auf Ihrem Server konfigurierten Webhooks](/de/virtual-goods/own-ui/server-side-token-generation/set-up-order-tracking/#payments_integration_order_tracking)
- [per Short-polling](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_short_polling)
- [per WebSocket API](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/#guides_shop_builder_integrate_store_get_order_status_via_websocket_api)
## Nützliche Links
- Authentifizierung
- [API-Aufrufe nach Interaktionsmodell](/de/api/catalog/section/authentication)
- [Zahlungstests](/de/dev-resources/testing/general-info/#general_overview)
- [Bestellstatus-Tracking einrichten](/de/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?link=200-api#payments_integration_order_tracking)
- [Webhooks](/de/webhooks/overview)
- [Ratenlimits](/de/api/login/rate-limits)
- [Fehlerbehandlung](/de/api/getting-started/#api_errors_handling)
- [API-Schlüssel](/de/api/getting-started/#api_keys_overview)
# Paginierung
API-Aufrufe, die umfangreiche Datensätze zurückgeben (beispielsweise beim Erstellen eines Katalogs), liefern Daten seitenweise. Die Paginierung ist ein Mechanismus, der die Anzahl der in einer einzelnen API-Antwort zurückgegebenen Elemente begrenzt und es ermöglicht, aufeinanderfolgende Seiten der Reihe nach abzurufen.
Mithilfe der folgenden Parameter können Sie die Anzahl der zurückgegebenen Elemente steuern:
- `limit` – Anzahl der Elemente pro Seite
- `offset` – Index des ersten Elements auf der Seite (Nummerierung beginnt bei 0)
- `has_more` – gibt an, ob eine weitere Seite verfügbar ist
- `total_items_count` – Gesamtanzahl der Elemente
Beispielanfrage:
```
GET /items?limit=20&offset=40
```
Beispielantwort:
```json
{
"items": [...],
"has_more": true,
"total_items_count": 135
}
```
Es wird empfohlen, nachfolgende Anfragen zu senden, bis die Antwort `has_more = false` zurückgibt.
# Datums- und Zeitformat
Datums- und Zeitwerte werden im [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)-Format übermittelt.
Folgende Formate werden unterstützt:
- UTC-Offset
- `null`-Wert, wenn keine zeitliche Einschränkung für die Anzeige eines Artikels besteht
- [Unix-Zeitstempel](https://www.unixtimestamp.com/) (in Sekunden), der in einigen Feldern verwendet wird
Format: `YYYY-MM-DDTHH:MM:SS±HH:MM`
Beispiel: `2026-03-16T10:00:00+03:00`
# Lokalisierung
Xsolla unterstützt die Lokalisierung von benutzerseitigen Feldern wie Artikelname und Beschreibung. Lokalisierte Werte werden als Objekt übermittelt, wobei der Sprachcode als Schlüssel verwendet wird. Die vollständige Liste der unterstützten Sprachen ist in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/) verfügbar.
**Unterstützte Felder**
Für die folgenden Parameter kann eine Lokalisierung festgelegt werden:
- `name`
- `description`
- `long_description`
**Gebietsschemaformat**
Der Gebietsschemaschlüssel kann in einem der folgenden Formate angegeben werden:
- Sprachencode bestehend aus zwei Buchstaben: `en`, `ru`
- Sprachencode bestehend aus fünf Buchstaben: `en-US`, `ru-RU`, `de-DE`
**Beispiele**
Zweistelliger Sprachencode (Beispiel):
```json
{
"name": {
"en": "Starter Pack",
"ru": "Стартовый набор"
}
}
```
Fünfstelliger Sprachencode (Beispiel):
```json
{
"description": {
"en-US": "Premium bundle",
"de-DE": "Premium-Paket"
}
}
```
# Fehlerantwortformat
Wenn ein Fehler auftritt, gibt die API einen HTTP-Statuscode und einen JSON-Antwortrumpf zurück. Die vollständige Liste der shopbezogenen Fehler ist in der [Dokumentation](/de/dev-resources/references/errors/store-errors/) verfügbar.
**Antwort (Beispiel):**
```json
{
"errorCode": 1102,
"errorMessage": "Validation error",
"statusCode": 422,
"transactionId": "c9e1a..."
}
```
- `errorCode` – Fehlercode.
- `errorMessage` – kurze Fehlerbeschreibung.
- `statusCode` – HTTP-Antwortstatus.
- `transactionId` – Anfrage-ID. Wird nur in einigen Fällen zurückgegeben.
- `errorMessageExtended` – zusätzliche Fehlerdetails, wie z. B. Anfrageparameter. Wird nur in einigen Fällen zurückgegeben.
**Erweiterte Antwort (Beispiel):**
```json
{
"errorCode": 7001,
"errorMessage": "Chain not found",
"errorMessageExtended": {
"chain_id": "test_chain_id",
"project_id": "test_project_id",
"step_number": 2
},
"statusCode": 404
}
```
**Gängige HTTP-Statuscodes**
- `400` – ungültige Anfrage
- `401` – Authentifizierungsfehler
- `403` – mangelnde Berechtigungen
- `404` – Ressource nicht gefunden
- `422` – Validierungsfehler
- `429` – Ratenlimit überschritten
**Empfehlungen**
- Verarbeiten Sie den HTTP-Statuscode und den Antwortrumpf gemeinsam.
- Verwenden Sie `errorCode`, um Fehler im Zusammenhang mit der Anwendungslogik zu verarbeiten.
- Verwenden Sie `transactionId`, um Anfragen bei der Fehleranalyse schneller zu identifizieren.
Version: 2.0.0
## Servers
```
https://store.xsolla.com/api
```
## Security
### basicAuth
Serverseitige Aufrufe verwenden das Authentifizierungsschema `basicAuth`. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` das gemäß dem 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:
* `merchant_id` wird angezeigt:
* unter **Firmeneinstellungen > Firma**.
* in der URL in der Adressleiste des Browsers auf einer beliebigen Seite im Kundenportal. Die URL hat das folgende Format: `https://publisher.xsolla.com/`.
* `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel in Ihrem System zu speichern. Einen API-Schlüssel können Sie an den folgenden Orten erstellen:
* unter [Firmeneinstellungen > API-Schlüssel](https://publisher.xsolla.com/0/settings/api_key)
* unter [Projekteinstellungen > API-Schlüssel](https://publisher.xsolla.com/0/projects/0/edit/api_key)
{% html name="div" attrs={"class": "notice"} %}
**Hinweis**
Falls bei einem erforderlichen API-Aufruf der Pfadparameter `project_id` fehlt, müssen Sie einen API-Schlüssel verwenden, der für alle Projekte der Firma gültig ist.
* `project_id` wird angezeigt:
* neben dem Projektnamen im Kundenportal.
* in der URL in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: `https://publisher.xsolla.com//projects/`.
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
### XsollaLoginUserJWT
Clientseitige Aufrufe verwenden das Authentifizierungsschema `XsollaLoginUserJWT`. In der Anfrage muss der JWT des Nutzers im `Authorization`-Header im folgenden Format enthalten sein: Bearer ``. Der Token identifiziert den Nutzer und gewährt Zugriff auf personalisierte Daten. Weitere Informationen zur Erstellung eines Tokens finden Sie in der [Dokumentation zur Xsolla-Login-API](/de/api/login/authentication-schemes#getting-user-token).
Alternativ können Sie einen [Token zum Öffnen des Zahlungsportals verwenden](/de/api/pay-station/token/create-token).
Type: http
Scheme: bearer
Bearer Format: JWT
### AuthForCart
Das Authentifizierungsschema `AuthForCart` wird für Warenkorbkäufe verwendet und unterstützt zwei Modi:
1. Authentifizierung mit einem Benutzer-JWT. Der Token wird im Authorization-Header im folgenden Format übermittelt: `Authorization: Bearer `, wobei `` der Benutzertoken ist. Der Token dient dazu, den Nutzer zu identifizieren und ihm Zugriff auf personalisierte Daten zu ermöglichen.
Alternativ können Sie einen [Token zum Öffnen des Zahlungsportals verwenden](/de/api/pay-station/token/create-token).
2. Vereinfachter Modus ohne `Authorization`-Header. Dieser Modus kommt nur bei nicht authentifizierten Nutzern zum Einsatz und kann nur für den [Verkauf von Spielschlüsseln](/de/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users) verwendet werden. Anstelle eines Tokens muss die Anfrage die folgenden Header enthalten:
* `x-unauthorized-id` samt Anfrage-ID
* `x-user` samt Base64-kodierter E-Mail-Adresse des Nutzers.
Type: http
Scheme: bearer
### basicMerchantAuth
Serverseitige Aufrufe verwenden das Authentifizierungsschema `basicMerchantAuth`. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` das gemäß dem Base64-Standard kodierte `merchant_id:api_key`-Paar ist.
Wechseln Sie ins [Kundenportal](https://publisher.xsolla.com/), um die Werte der Parameter zu erhalten:
* `merchant_id` wird angezeigt:
* unter **Firmeneinstellungen > Firma**
* in der URL in der Adressleiste des Browsers auf einer beliebigen Seite im Kundenportal. Die URL hat das folgende Format: `https://publisher.xsolla.com/`
* `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel in Ihrem System zu speichern. Einen neuen Schlüssel können Sie unter [Firmeneinstellungen > API-Schlüssel](https://publisher.xsolla.com/0/settings/api_key) erstellen.
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
[LiveOps-API](https://developers.xsolla.com/_bundle/@l10n/de/api/liveops/index.yaml)
## Allgemeine API-Aufrufe
Mit den API-Methoden aus diesem Unterabschnitt können Sie verschiedene Arten von Werbeaktionen verwalten.
### Liste aller Werbeaktionen abrufen
- [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/de/api/liveops/promotions-common/get-promotion-list.md): Ruft die Liste der Werbeaktionen eines Projekts ab.
### Werbeaktion aktivieren
- [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/de/api/liveops/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/liveops/promotions-common/deactivate-promotion.md): Deaktiviert eine Werbeaktion.
### Werbeaktion anhand von einlösbarem Code abrufen
- [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/de/api/liveops/promotions-common/get-redeemable-promotion-by-code.md): Ruft die Werbeaktion anhand eines Promocodes oder Gutscheincodes ab.
### Aktionscode überprüfen
- [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/de/api/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## Gutscheine
Mit den API-Methoden aus diesem Unterabschnitt können Sie Gutscheinaktionen konfigurieren und verwalten.
Hinweis
Weitere Informationen zu Gutscheinen finden Sie in unserer Dokumentation.
### Gutscheincode einlösen
- [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/de/api/liveops/promotions-coupons/redeem-coupon.md): Löst einen Gutscheincode ein. Der Nutzer erhält nach dem Einlösen eines Gutscheins einen Bonus.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Gutscheinbelohnung abrufen
- [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/de/api/liveops/promotions-coupons/get-coupon-rewards-by-code.md): Ruft Gutscheinbelohnungen anhand des Codes ab.
Dadurch können Nutzer aus mehreren Bonusartikeln wählen.
In der Regel wird ein DRM-System ausgewählt, wenn der Gutschein ein Spiel als Bonus gewährt (type=unit).
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Gutscheinaktionen erstellen
- [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/de/api/liveops/promotions-coupons/admin-create-coupon.md): Erstellt eine Gutscheinaktion.
### Liste der Gutscheinaktionen abrufen
- [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/de/api/liveops/promotions-coupons/get-coupons.md): Ruft die Liste der Gutscheinaktionen eines Projekts ab.
### Gutscheinaktion aktualisieren
- [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-coupons/update-coupon-promotion.md): Aktualisiert eine Gutscheinaktion.
### Gutscheinaktion abrufen
- [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-coupons/get-coupon.md): Ruft eine angegebene Gutscheinaktion ab.
### Gutscheinaktion löschen
- [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/de/api/liveops/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 aktivieren
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/de/api/liveops/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.
### Gutscheinaktion deaktivieren
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/de/api/liveops/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.
### Gutscheincode erstellen
- [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-coupons/create-coupon-code.md): Erstellt einen Gutscheincode.
### Gutscheincodes abrufen
- [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-coupons/get-coupon-codes.md): Ruft Gutscheincodes ab.
In der Antwort sind die Gesamtzahl der Codes in der Werbeaktion (total_count) sowie die Codes für die aktuelle Seite (codes) enthalten. Um die nächste Seite abzurufen, erhöhen Sie offset um den limit-Wert (z. B. “offset”: 100, dann “offset”: 200), bis Sie alle Codes abgerufen haben.
In den meisten Fällen ist “limit”: 100 oder “limit”: 1000 ausreichend. Größere Werte wie “limit”: 10000 sind einmaligen Massenexporten vorbehalten. Vermeiden Sie es, “limit”: 50000 anzugeben, sofern dies nicht unbedingt erforderlich ist.
### Gutscheincodes generieren
- [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/de/api/liveops/promotions-coupons/generate-coupon-codes.md): Generiert Gutscheincodes.
Richtlinien zur Codegenerierung:
* Es gibt keine Höchstzahl an Codes pro Werbeaktion, jedoch ist jede Anfrage auf 50.000 Codes begrenzt. Anfragen mit einer höheren Anzahl führen zur Fehlermeldung 422 Unprocessable Entity. Wenn Sie mehr als 50.000 Codes benötigen, senden Sie bitte mehrere Anfragen.
* Aus Gründen der Zuverlässigkeit empfehlen wir, Codes in kleineren Stapeln zu generieren, d. h. bis zu 10.000 pro Anfrage. Wenn Sie beispielsweise 100.000 Codes erstellen möchten, sollten Sie zehn Anfragen mit "count": 10000 senden anstelle von zwei Anfragen mit "count": 50000. Warten Sie bei jeder Anfrage, bis Sie eine erfolgreiche Antwort erhalten haben, bevor Sie die nächste Anfrage senden.
* Beachten Sie die Ratenbegrenzung von 15 Anfragen pro Sekunde. Wenn Sie große Datenmengen generieren, sollten Sie die Anfragen nacheinander senden, um eine Überschreitung der Ratenbegrenzung und damit einen 429-Fehler zu vermeiden.
* Die Liste der Codes können Sie mit der Methode Gutscheincode abrufen abrufen.
| Parameter | Wert |
|---|---|
| Mindestzahl an Codes pro Anfrage. | 1 |
| Höchstzahl an Codes pro Anfrage. Nur verwenden, wenn Sie die größtmögliche Anzahl auf einmal abrufen müssen. | 50.000 |
| Empfohlene Anzahl von Codes pro Anfrage. | Bis zu 10.000. Sollten Sie mehr Codes erstellen müssen, senden Sie mehrere aufeinanderfolgende Anfragen. |
### 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/liveops/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
### Limits eindeutiger Gutscheincodes abrufen
- [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/de/api/liveops/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
## Promocodes
Mit den API-Methoden aus diesem Unterabschnitt können Sie Promocode-Aktionen konfigurieren und verwalten.
Hinweis
Weitere Informationen zu Promocodes finden Sie in unserer Dokumentation.
### Promocode einlösen
- [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/de/api/liveops/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/liveops/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.
### Promocode-Belohnungen abrufen
- [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/de/api/liveops/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.
In der Regel wird ein DRM-System ausgewählt, wenn der Promocode ein Spiel als Bonus gewährt (type=unit).
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Promocode-Aktion erstellen
- [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/create-promo-code.md): Erstellt eine Promocode-Aktion.
### Liste der Promocode-Aktionen abrufen
- [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/get-promo-codes.md): Ruft die Liste der Promocodes eines Projekts ab.
### Promocode-Aktion aktualisieren
- [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/update-promo-code.md): Aktualisiert eine Promocode-Aktion.
### Promocode-Aktion abrufen
- [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/get-promo-code.md): Ruft eine angegebene Promocode-Aktion ab.
### Promocode löschen
- [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/de/api/liveops/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 aktivieren
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/de/api/liveops/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.
### Promocode-Aktion deaktivieren
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/de/api/liveops/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.
### Code für Promocode-Aktion erstellen
- [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/create-promo-code-code.md): Erstellt Code für eine Promocode-Aktion.
### Codes von Promocode-Aktion abrufen
- [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/get-promocode-codes.md): Ruft Codes einer Promocode-Aktion ab.
In der Antwort sind die Gesamtzahl der Codes in der Werbeaktion (total_count) sowie die Codes für die aktuelle Seite (codes) enthalten. Um die nächste Seite abzurufen, erhöhen Sie offset um den limit-Wert (z. B. “offset”: 100, dann “offset”: 200), bis Sie alle Codes abgerufen haben.
In den meisten Fällen ist “limit”: 100 oder “limit”: 1000 ausreichend. Größere Werte wie “limit”: 10000 sind einmaligen Massenexporten vorbehalten. Vermeiden Sie es, “limit”: 50000 anzugeben, sofern dies nicht unbedingt erforderlich ist.
### Codes für eine Promocode-Aktion generieren
- [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/de/api/liveops/promotions-promo-codes/generate-promo-code-codes.md): Generiert Codes für eine Promocode-Aktion.
Richtlinien zur Codegenerierung:
* Es gibt keine Höchstzahl an Codes pro Werbeaktion, jedoch ist jede Anfrage auf 50.000 Codes begrenzt. Anfragen mit einer höheren Anzahl führen zur Fehlermeldung 422 Unprocessable Entity. Wenn Sie mehr als 50.000 Codes benötigen, senden Sie bitte mehrere Anfragen.
* Aus Gründen der Zuverlässigkeit empfehlen wir, Codes in kleineren Stapeln zu generieren, d. h. bis zu 10.000 pro Anfrage. Wenn Sie beispielsweise 100.000 Codes erstellen möchten, sollten Sie zehn Anfragen mit "count": 10000 senden anstelle von zwei Anfragen mit "count": 50000. Warten Sie bei jeder Anfrage, bis Sie eine erfolgreiche Antwort erhalten haben, bevor Sie die nächste Anfrage senden.
* Beachten Sie die Ratenbegrenzung von 15 Anfragen pro Sekunde. Wenn Sie große Datenmengen generieren, sollten Sie die Anfragen nacheinander senden, um eine Überschreitung der Ratenbegrenzung und damit einen 429-Fehler zu vermeiden.
* Die Liste der Codes können Sie mit der Methode Codes von Promocode-Aktion abrufen abrufen.
| Parameter | Wert |
|---|---|
| Mindestzahl an Codes pro Anfrage. | 1 |
| Höchstzahl an Codes pro Anfrage. Nur verwenden, wenn Sie die größtmögliche Anzahl auf einmal abrufen müssen. | 50.000 |
| Empfohlene Anzahl von Codes pro Anfrage. | Bis zu 10.000. Sollten Sie mehr Codes erstellen müssen, senden Sie mehrere aufeinanderfolgende Anfragen. |
### 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/liveops/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-Limit für Codes abrufen
- [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/de/api/liveops/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
## Katalogsonderangebote
Mit den API-Methoden aus diesem Unterabschnitt können Sie Katalogsonderangebote konfigurieren und verwalten.
Hinweis
Weitere Informationen zu Sonderangeboten finden Sie in unserer Dokumentation.
### Katalogsonderangebot erstellen
- [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Erstellt ein Katalogsonderangebot.
### Liste von Katalogsonderangeboten abrufen
- [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Ruft die Liste der Katalogsonderangebote eines Projekts ab.
### Katalogsonderangebot aktualisieren
- [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Aktualisiert das Katalogsonderangebot.
### Katalogsonderangebot abrufen
- [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Ruft das angegebene Katalogsonderangebot ab.
### Katalogsonderangebotsaktion löschen
- [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/de/api/liveops/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 aktivieren
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/de/api/liveops/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.
### Katalogsonderangebot deaktivieren
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/de/api/liveops/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.
### Code für Katalogsonderangebote erstellen
- [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Erstellt einen Code für Katalogsonderangebote.
### Codes für Katalogsonderangebote abrufen
- [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Ruft Codes für Katalogsonderangebote ab.
### Codes für Katalogsonderangebote generieren
- [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/de/api/liveops/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Generiert Codes für Katalogsonderangebote.
## Rabatte
Mit den API-Methoden aus diesem Unterabschnitt können Sie Rabattaktionen konfigurieren und verwalten.
Hinweis
Weitere Informationen zu Rabatten finden Sie in unserer Dokumentation.
### Rabattaktion für Artikel erstellen
- [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/de/api/liveops/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.
### Liste der Artikelaktionen abrufen
- [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/de/api/liveops/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.
### Artikelaktion aktualisieren
- [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/liveops/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.
### Artikelaktion abrufen
- [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/liveops/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 löschen
- [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/de/api/liveops/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.
## Boni
Mit den API-Methoden aus diesem Unterabschnitt können Sie Bonusaktionen konfigurieren und verwalten.
Hinweis
Weitere Informationen zu Boni finden Sie in unserer Dokumentation.
### Bonusaktion erstellen
- [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/de/api/liveops/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.
### Liste der Bonusaktionen abrufen
- [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/de/api/liveops/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 aktualisieren
- [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/liveops/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.
### Bonusaktion abrufen
- [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/liveops/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 löschen
- [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/de/api/liveops/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.
## Personalisierter Katalog
Mithilfe der Personalisierung können Sie die Bedingungen festlegen, unter denen der Artikelkatalog und Werbeaktionen bestimmten autorisierten Nutzern angezeigt werden. Die Bedingungen werden auf der Grundlage von Nutzerattributen definiert und ermöglichen es Ihnen, Artikeln und Werbeaktionen anzubieten, die für bestimmte Nutzer am relevantesten sind.
Die folgenden Personalisierungstypen sind verfügbar:
* [Personalisierung aufseiten von Xsolla](/de/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). Personalisierungsregeln und ‑logik werden aufseiten von Xsolla konfiguriert und gespeichert. Sie übermitteln die Nutzerattribute, und basierend darauf erstellt Xsolla einen personalisierten Katalog.
* [Personalisierung aufseiten des Partners](/de/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). Sie konfigurieren die Personalisierungsregeln und ‑logik in Ihrem System und senden eine endgültige Katalog-Payload für einen bestimmten Nutzer an Xsolla.
Hinweis
Sie können nur einen Personalisierungstyp verwenden. Wie Sie den Personalisierungstyp ändern, erfahren Sie in der
Anleitung.
So konfigurieren Sie die Personalisierung aufseiten von Xsolla mithilfe der Xsolla-API:
1. Erstellen Sie Artikel mit den API-Aufrufen aus dem Unterabschnitt **Verwaltung** der Gruppen [Virtuelle Gegenstände und Währung](/de/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Bundles](/de/api/catalog/bundles-admin/admin-create-bundle) oder [Spielschlüssel](/de/api/catalog/game-keys-admin).
2. [Richten Sie Nutzerattribute mit der Xsolla-Login-API ein](/de/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes), und halten Sie diese synchron, indem Sie die Daten in Xsolla aktualisieren, sobald sich in Ihrem Spiel Änderungen ergeben.
3. Konfigurieren Sie die Personalisierung für Artikel oder Werbeaktionen:
* Um den Artikelkatalog zu personalisieren, müssen Sie Kataloganzeigeregeln mit dem API-Aufruf [Katalogfilterregel erstellen](/de/api/liveops/personalized-catalog/create-filter-rule) definieren:
* Legen Sie im Array [attribute_conditions](/de/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) die Bedingungen (auf Basis von Nutzerattributen) fest, unter denen die Artikel verfügbar sind.
* Geben Sie im Array [items](/de/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) die Liste der Artikel an, die dem Nutzer angezeigt werden sollen, wenn dessen Attribute den festgelegten Bedingungen entsprechen
* Verwenden Sie die [API-Aufrufe zum Erstellen und Aktualisieren des gewünschten Werbeaktionstyp](/de/api/liveops/promotions-discounts/create-item-promotion), um personalisierte Werbeaktionen zu konfigurieren. Legen Sie im Array [attribute_conditions](/de/api/liveops/promotions-discounts/create-item-promotion) die Bedingungen (auf Basis von Nutzerattributen) fest, unter denen die Werbeaktion verfügbar ist.
4. Übermitteln Sie den [Benutzer-JWT](/de/api/login/getting-user-token?#getting-user-token) mitsamt der Nutzerattribute an die [API-Aufrufe zur Katalogabfrage](https://developers.xsolla.com/de/api/catalog/virtual-items-currency-catalog/get-virtual-items), um einen personalisierten Katalog abzurufen.
**Konfiguration und Anwendung der Xsolla-seitigen Personalisierung für den Artikelkatalog (Ablauf):**
**Konfiguration und Anwendung der Xsolla-seitigen Personalisierung für Werbeaktionen (Ablauf):**
Hinweis
Detaillierte Informationen finden Sie:
### Liste der Katalogfilterregeln abrufen
- [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/de/api/liveops/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/liveops/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/liveops/personalized-catalog/get-all-filter-rules.md): Ruft eine Liste aller Katalogregeln zum clientseitigen Durchsuchen ab.
AchtungGibt nur Regel-ID, Name und is_enabled zurück
### Katalogfilterregel abrufen
- [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/liveops/personalized-catalog/get-filter-rule-by-id.md): Bestimmte für Benutzerattribute geltende Regel abrufen
### Katalogfilterregel aktualisieren
- [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/liveops/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).
### Katalogfilterregel patchen
- [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/liveops/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 löschen
- [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/de/api/liveops/personalized-catalog/delete-filter-rule-by-id.md): Löscht eine bestimmte Regel.
## Verwaltung
### Alle Werbeaktionslimits für den angegebenen Benutzer aktualisieren
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/de/api/liveops/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 Benutzer aktualisieren
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/de/api/liveops/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
### Werbeaktionslimit für angegebenen Benutzer abrufen
- [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/liveops/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 Abschnitt "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/liveops/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 Abschnitt "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/liveops/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 angegebenen Benutzer herabsetzen
- [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/de/api/liveops/user-limits-admin/remove-user-promotion-limit.md): Verringert 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 Abschnitt "Verwaltung" der gewünschten Werbeaktionsart:
* Rabattaktionen
* Bonusaktionen
## Administrator
### Liste der Wertpunkte abrufen
- [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/de/api/liveops/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/liveops/reward-chain-value-points-admin/admin-create-value-points.md): Erstellt einen Wertpunkt.
### Wertpunkt abrufen
- [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/de/api/liveops/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/liveops/reward-chain-value-points-admin/admin-update-value-point.md): Aktualisiert einen durch Angabe der SKU festgelegten Wertpunkt.
### Wertpunkte löschen
- [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/de/api/liveops/reward-chain-value-points-admin/admin-delete-value-point.md): Löscht einen durch Angabe der SKU festgelegten Wertpunkt.
### 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/liveops/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 festlegen
- [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/liveops/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.
### 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/liveops/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 von Artikeln löschen
- [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/de/api/liveops/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Entfernt Wertpunktbelohnungen von ALLEN Artikeln.
### Liste der Belohnungsketten abrufen
- [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/de/api/liveops/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/liveops/reward-chain-value-points-admin/admin-create-reward-chain.md): Erstellt eine Belohnungskette.
### Belohnungskette abrufen
- [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/de/api/liveops/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/liveops/reward-chain-value-points-admin/admin-update-reward-chain.md): Aktualisiert eine bestimmte Belohnungskette.
### Belohnungskette löschen
- [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/de/api/liveops/reward-chain-value-points-admin/admin-delete-reward-chain.md): Löscht eine bestimmte Belohnungskette.
### Belohnungskette aktivieren/deaktivieren
- [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/de/api/liveops/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Aktiviert/deaktiviert die Belohnungskette.
### Belohnungskette zurücksetzen
- [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/de/api/liveops/reward-chain-value-points-admin/admin-reset-reward-chain.md): Setzt das Wertpunkte-Guthaben und den Fortschritt aller Nutzer in der Belohnungskette zurück.Das Guthaben ist an den Wertpunkttyp gebunden, nicht an eine bestimmte Belohnungskette. Werden die Wertpunkte auch in anderen Ketten verwendet, wird das Guthaben in allen Ketten zurückgesetzt, in denen diese Wertpunkte zum Einsatz kommen. Nach dem Zurücksetzen können Sie die Gültigkeitsdauer der Belohnungskette aktualisieren, und die Nutzer können diese erneut durchlaufen. Das Clan-Guthaben berechnet sich aus der Summe der Guthaben der einzelnen Clan-Mitglieder. Daher ist nach dem Zurücksetzen auch das Clan-Guthaben zurückgesetzt. Diese Anfrage ist irreversibel und gilt für alle Nutzer des Projekts.
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.
## Client
### Belohnungsketten des aktuellen Nutzers abrufen
- [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/de/api/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Wertpunktestand des aktuellen Nutzers abrufen
- [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/de/api/liveops/reward-chain-client/get-user-reward-chain-balance.md): Client-Endpunkt. Ruft das Wertpunkte-Guthaben des aktuellen Nutzers ab.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Schrittbelohnung gewähren
- [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/de/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward.md): Client-Endpunkt. Gewährt dem aktuellen Nutzer die Schrittbelohnung aus einer Belohnungskette.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## 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/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Den Clan des aktuellen Nutzers aktualisieren
- [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/de/api/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## Administrator
### Liste der täglichen Belohnungen abrufen
- [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/de/api/liveops/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/liveops/daily-chain-admin/admin-create-daily-chain.md): Erstellt eine 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/liveops/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/liveops/daily-chain-admin/admin-update-daily-chain.md): Aktualisiert eine bestimmte 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/liveops/daily-chain-admin/admin-delete-daily-chain.md): Löscht eine bestimmte tägliche Belohnung.
### Tägliche Belohnung aktivieren/deaktivieren
- [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/de/api/liveops/daily-chain-admin/admin-toggle-daily-chain.md): Aktiviert oder deaktiviert eine 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/liveops/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.
## Client
### Tägliche Belohnungen des aktuellen Nutzers abrufen
- [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/de/api/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### 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/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### 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/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## Administrator
### Liste der Angebotsketten abrufen
- [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/de/api/liveops/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/liveops/offer-chain-admin/admin-create-offer-chain.md): Erstellt eine Angebotskette.
### Angebotskette abrufen
- [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/de/api/liveops/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/liveops/offer-chain-admin/admin-update-offer-chain.md): Aktualisiert eine bestimmte Angebotskette.
### Angebotskette löschen
- [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/de/api/liveops/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 aktivieren/deaktivieren
- [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/de/api/liveops/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.
## Client
### Angebotsketten des aktuellen Nutzers abrufen
- [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/de/api/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### 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/liveops/offer-chain-client/get-user-offer-chain-by-id.md): Ruft die Angebotskette des aktuellen Nutzers anhand der Angebotsketten-ID ab.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### 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/liveops/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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### 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/liveops/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.
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
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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## payment-client-side
### 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/liveops/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.
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
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.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## Administrator
### Informationen zum Upselling im Projekt abrufen
- [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/de/api/liveops/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/liveops/upsell-admin/post-upsell.md): Erstellt einen Upselling-Artikel für ein Projekt.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Upselling aktualisieren
- [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/de/api/liveops/upsell-admin/put-upsell.md): Aktualisiert einen Upselling-Artikel für ein Projekt.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
### Upselling-Artikel des Projekts aktivieren/deaktivieren
- [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/de/api/liveops/upsell-admin/put-upsell-toggle-active-inactive.md): Ändert den Status von Upselling-Artikeln in einem Projekt auf "aktiv" oder "inaktiv".
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.
## Client
### Liste der Upselling-Artikel im Projekt abrufen
- [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/de/api/liveops/upsell-client/get-upsell-for-project-client.md): Ruft eine Liste der Upselling-Artikel in einem Projekt ab, sofern diese bereits eingerichtet wurden.
Hinweis
Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.