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

Attributwert erstellenServer-sideAdmin

Anfrage

Erstellt einen Attributwert.

Achtung

Bei allen Projekten ist die Anzahl der Attributwerte begrenzt. Der Standard- und Höchstwert beträgt 20 Werte pro Attribut.
Sicherheit
basicAuth
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
external_idstringerforderlich

Externe ID des Attributs.

Beispiel: attribute_id
Bodyapplication/json
external_idstring(value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$erforderlich

Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

Beispiel: "attribute_value"
valueobject(value-name)erforderlich

Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

Standard {"de":"Strategie","en":"Strategy"}
Beispiel: {"de":"Strategie","en":"Strategy"}
value.​property name*stringzusätzliche Eigenschaft
curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/admin/attribute/attribute_id/value \
  -H 'Content-Type: application/json' \
  -d '{
    "external_id": "weapon_class_sword_value",
    "value": {
      "de": "Schwert",
      "en": "Sword"
    }
  }'

Antworten

Attributwert wurde erfolgreich erstellt.

Bodyapplication/json
external_idstring(value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$

Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

Beispiel: "attribute_value"
Antwort
application/json
{ "external_id": "rpg" }

Attributwert löschenServer-sideAdmin

Anfrage

Löscht einen Attributwert.

Hinweis

Wenn Sie den Wert eines Attributs löschen, gehen alle Verbindungen zwischen dem Attribut und den Artikeln verloren. Verwenden Sie zum Ändern des Attributwerts eines Artikels den API-Aufruf Attributwert aktualisieren, anstatt den Wert zu löschen und einen neuen zu erstellen.
Sicherheit
basicAuth
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
value_external_idstring^[-_\.\d\w]+$erforderlich

Externe ID des Attributwerts.

Beispiel: value_id
external_idstringerforderlich

Externe ID des Attributs.

Beispiel: attribute_id
curl -i -X DELETE \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/admin/attribute/attribute_id/value/value_id

Antworten

Attributwert wurde erfolgreich gelöscht.

Antwort
Kein Inhalt

Attributwert aktualisierenServer-sideAdmin

Anfrage

Aktualisiert einen Attributwert.

Sicherheit
basicAuth
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
value_external_idstring^[-_\.\d\w]+$erforderlich

Externe ID des Attributwerts.

Beispiel: value_id
external_idstringerforderlich

Externe ID des Attributs.

Beispiel: attribute_id
Bodyapplication/json
external_idstring(value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$erforderlich

Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

Beispiel: "attribute_value"
valueobject(value-name)erforderlich

Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

Standard {"de":"Strategie","en":"Strategy"}
Beispiel: {"de":"Strategie","en":"Strategy"}
value.​property name*stringzusätzliche Eigenschaft
curl -i -X PUT \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/de/api/shop-builder/v2/project/44056/admin/attribute/attribute_id/value/value_id \
  -H 'Content-Type: application/json' \
  -d '{
    "external_id": "weapon_class_sword_value",
    "value": {
      "de": "Schwert",
      "en": "Sword"
    }
  }'

Antworten

Attributwert wurde erfolgreich aktualisiert.

Antwort
Kein Inhalt

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
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen
Operationen