Zum Inhalt springen
/
Warenkorb des aktuellen B...

Digital Distribution Hub (1.0.0)

Ü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 und Bezahlstation. 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 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.
OpenAPI-Beschreibung herunterladen
index.json
index.yaml
Sprachen
Server
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/de/api/digital-distribution-hub/

Warenkorb

Operationen

Warenkorb des aktuellen Benutzers abrufen

Anfrage

Gibt den Warenkorb des aktuellen Benutzers zurück.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
Abfrage
currencystring

Die Währung, in der die Preise angezeigt werden (standardmäßig USD). Währungscode, bestehend aus drei Buchstaben, gemäß ISO 4217.

Standard "USD"
localestring

Antwortsprache. Sprachcode, bestehend aus zwei Kleinbuchstaben, gemäß ISO 639-1.

Standard "en"
curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/44056/cart?currency=USD&locale=en' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Der Warenkorb samt Artikeln wurde erfolgreich zurückgegeben.

Bodyapplication/json
cart_idstring

Warenkorb-ID.

Beispiel: "cart_id"
is_freeboolean

Ist true festgelegt, ist der Warenkorb kostenlos.

itemsArray of objects(Cart_inline_response_200_items)
Beispiel: [{"attributes":[],"description":"Take it, take it all! All of Xsollas riches in one Mega Booster.","groups":[{"external_id":"powerups","name":"Power Ups"}],"image_url":"https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png","inventory_options":{"consumable":{"usages_count":1}},"is_free":false,"name":"Xsolla Booster Mega","price":{"amount":"50.0000000000000000","amount_without_discount":"100.0000000000000000","currency":"USD"},"quantity":123,"sku":"booster_mega_1","type":"virtual_good","virtual_item_type":"consumable","virtual_prices":[]}]
items[].​attributesArray of objects(Cart_client-attributes)

Liste der dem Artikel zugeordneten Attribute und deren Werte. Kann für die Katalogfilterung verwendet werden.

Standard []
Beispiel: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}
items[].​attributes[].​external_idstring(Cart_admin-attribute-external_id)[ 1 .. 255 ] characters^[a-zA-Z0-9-_]+$

Eindeutige Attribut-ID. Die external_id darf nur lateinische alphanumerische Kleinbuchstaben, Bindestriche und Unterstriche enthalten.

Beispiel: "attribute_1"
items[].​attributes[].​namestring

Name des Attributs.

Beispiel: "Genre"
items[].​attributes[].​valuesArray of objects
items[].​attributes[].​values[].​external_idstring(Cart_value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$

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

Beispiel: "attribute_value"
items[].​attributes[].​values[].​valuestring

Wert des Attributs.

Beispiel: "Strategy"
items[].​descriptionstring
items[].​groupsArray of objects(Cart_inline_response_200_groups)
items[].​groups[].​external_idstring
items[].​groups[].​namestring
items[].​image_urlstring
items[].​is_freeboolean
items[].​namestring or null
items[].​quantityinteger
items[].​skustring
items[].​typestring
priceobject or null(Cart_inline_response_200_price)

Warenkorbpreis.

Beispiel: "{\"amount\":\"6150.0000000000000000\",\"amount_without_discount\":\"6150.0000000000000000\",\"currency\":\"USD\"}"
price.​amountstring
Standard "50.0000000000000000"
price.​amount_without_discountstring
Standard "100.0000000000000000"
price.​currencystring
Standard "USD"
Antwort
application/json
{
  "cart_id": "cart_id",
  "is_free": false,
  "items": [
    { … }
  ],
  "price": {
    "amount": "6150.0000000000000000",
    "amount_without_discount": "6150.0000000000000000",
    "currency": "USD"
  }
}

Alle Warenkorbartikel aus dem aktuellen Warenkorb löschen

Anfrage

Löscht alle Artikel aus dem Warenkorb.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
curl -i -X PUT \
  https://store.xsolla.com/api/v2/project/44056/cart/clear \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Der Warenkorb wurde erfolgreich geleert.

Artikel in den Warenkorb legen

Anfrage

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.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
Bodyapplication/json
currencystring(Cart-Payment_settings_currency)

Bevorzugte Zahlungswährung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

itemsArray of objectserforderlich

Liste von Artikeln.

items[].​quantitynumbererforderlich
Standard 123
items[].​skustringerforderlich
Standard "booster_mega_1"
curl -i -X PUT \
  https://store.xsolla.com/api/v2/project/44056/cart/fill \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "quantity": 123,
      "sku": "booster_mega_1"
    }
  ]'

Antworten

Der Warenkorb samt Artikeln wurde erfolgreich zurückgegeben.

Bodyapplication/json
cart_idstring

Warenkorb-ID.

Beispiel: "cart_id"
is_freeboolean

Ist true festgelegt, ist der Warenkorb kostenlos.

itemsArray of objects(Cart_inline_response_200_items)
items[].​attributesArray of objects(Cart_client-attributes)

Liste der dem Artikel zugeordneten Attribute und deren Werte. Kann für die Katalogfilterung verwendet werden.

Standard []
Beispiel: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}
items[].​attributes[].​external_idstring(Cart_admin-attribute-external_id)[ 1 .. 255 ] characters^[a-zA-Z0-9-_]+$

Eindeutige Attribut-ID. Die external_id darf nur lateinische alphanumerische Kleinbuchstaben, Bindestriche und Unterstriche enthalten.

Beispiel: "attribute_1"
items[].​attributes[].​namestring

Name des Attributs.

Beispiel: "Genre"
items[].​attributes[].​valuesArray of objects
items[].​attributes[].​values[].​external_idstring(Cart_value-external_id)[ 1 .. 255 ] characters^[-_.\d\w]+$

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

Beispiel: "attribute_value"
items[].​attributes[].​values[].​valuestring

Wert des Attributs.

Beispiel: "Strategy"
items[].​descriptionstring
items[].​groupsArray of objects(Cart_inline_response_200_groups)
items[].​groups[].​external_idstring
items[].​groups[].​namestring
items[].​image_urlstring
items[].​is_freeboolean
items[].​namestring or null
items[].​quantityinteger
items[].​skustring
items[].​typestring
priceobject or null(Cart_inline_response_200_price)

Warenkorbpreis.

Beispiel: "{\"amount\":\"6150.0000000000000000\",\"amount_without_discount\":\"6150.0000000000000000\",\"currency\":\"USD\"}"
price.​amountstring
Standard "50.0000000000000000"
price.​amount_without_discountstring
Standard "100.0000000000000000"
price.​currencystring
Standard "USD"
warningsArray of objects(Cart_inline_response_200_1_warnings)
Beispiel: [{"attributes":[],"description":"Take it, take it all! All of Xsollas riches in one Mega Booster.","groups":[{"external_id":"powerups","name":"Power Ups"}],"image_url":"https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png","inventory_options":{"consumable":{"usages_count":1}},"is_free":false,"name":"Xsolla Booster Mega","price":{"amount":"50.0000000000000000","amount_without_discount":"100.0000000000000000","currency":"USD"},"quantity":123,"sku":"booster_mega_1","type":"virtual_good","virtual_item_type":"consumable","virtual_prices":[]}]
warnings[].​errorCodeinteger
warnings[].​errorMessagestring
warnings[].​quantityinteger
warnings[].​skustring
Antwort
application/json
{
  "cart_id": "cart_id",
  "is_free": false,
  "items": [
    { … }
  ],
  "price": {
    "amount": "6150.0000000000000000",
    "amount_without_discount": "6150.0000000000000000",
    "currency": "USD"
  },
  "warnings": [
    { … }
  ]
}

Spielschlüssel

Operationen

Virtuelle Gegenstände und Währung

Operationen

Bundles

Operationen

Benutzertoken

Operationen

Benachrichtigungen

Operationen

Bestellung

Operationen