Zum Inhalt springen

Overview

  • Version: 2.0.0
  • Servers: https://store.xsolla.com/api
  • Contact Us by Email
  • Contact URL: https://xsolla.com/
  • Required TLS version: 1.2

Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.

OpenAPI-Beschreibung herunterladen
Sprachen
Server
Mock server
https://xsolla.redocly.app/_mock/de/api/shop-builder/
https://store.xsolla.com/api/
Operationen

Personalisierter Katalog

Diese API ermöglicht es, Regeln für Benutzerattribute festzulegen. Wenn der Nutzer alle Bedingungen einer konkreten Regel erfüllt, werden personalisierte Artikel angezeigt.

Für personalisierte Werbeaktionen siehe Abschnitt Werbeaktionen.

Um Attribute vor einem Kauf zu übermitteln, können Sie die Xsolla Login API verwenden oder die Attribute in der Eigenschaft user.attributes übermitteln, während Sie den Token mit der Pay Station API generieren.

Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen

Katalog

Diese API ermöglicht es, jede Art von verkäuflichen oder bestimmten Artikeln zu erhalten.

Operationen
Operationen
Operationen
Operationen
Operationen
Operationen

Gutscheine

Mit dieser API können Sie Gutscheine verwalten.

Operationen

Promocodes

Diese API ermöglicht die Verwaltung von Promocodes.

Operationen

Katalogsonderangebote

Mit dieser API können Sie Katalogsonderangebote verwalten.

Operationen

Rabatte

Mit dieser API können Sie Rabattaktionen verwalten.

Operationen

Boni

Diese API ermöglicht die Verwaltung von Bonusaktionen.

Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen

Top-10-Liste der Personen abrufen, die am meisten zur Clan-Belohnungskette beigetragen habenClient-side

Anfrage

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.

Sicherheit
XsollaLoginUserJWT
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
reward_chain_idintegererforderlich

Belohnungsketten-ID.

Beispiel: 101
curl -i -X GET \
  https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/user/clan/contributors/101/top \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Die Top-10-Liste der Personen, die am meisten zur Clan-Belohnungskette beigetragen haben.

Bodyapplication/jsonArray [
contributed_amountinteger

Die Anzahl der vom Nutzer beigesteuerten Wertpunkte.

Beispiel: 100
namestring

Benutzer-ID. Die ID, die während der Autorisierung an Xsolla gesendet wird und über die der Nutzer Ihrem Xsolla-Login-Projekt zugeordnet ist.

Beispiel: "Rocket"
]
Antwort
application/json
[ { "contributed_amount": 555, "name": "winner" }, { "contributed_amount": 398, "name": "Rocket" }, { "contributed_amount": 201, "name": "MrJoe" }, { "contributed_amount": 1, "name": "beginner" } ]

Den Clan des aktuellen Nutzers aktualisierenClient-side

Anfrage

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.

Sicherheit
XsollaLoginUserJWT
Pfad
project_idintegererforderlich

Projekt-ID.

Standard 44056
curl -i -X PUT \
  'https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/{project_id}/user/clan/update' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Der Clan des Nutzers wurde erfolgreich aktualisiert.

Bodyapplication/json
rewardArray of objects
Antwort
application/json
{ "reward": [ {}, {} ] }
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen