Zum Inhalt springen
/
Liste der virtuellen Gege...

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

Spielschlüssel

Operationen

Virtuelle Gegenstände und Währung

Operationen

Liste der virtuellen Währungspakete abrufen

Anfrage

Ruft eine Liste von virtuellen Währungspaketen zum Erstellen eines Katalogs ab.

Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen.
Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
Abfrage
limitinteger

Obergrenze der Elementanzahl auf der Seite.

Beispiel: limit=50
offsetinteger

Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

Beispiel: offset=0
localestring

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

Standard "en"
additional_fields[]Array of strings

Die Liste der zusätzlichen Felder. Diese Felder werden in der Antwort angezeigt, sofern sie in der Anfrage gesendet werden. Verfügbare Felder: media_list, order, long_description.

countrystring

Land, für das regionale Preise berechnet und Katalogeinschränkungen festgelegt werden. Ländercode, bestehend aus zwei Großbuchstaben, gemäß ISO 3166-1 Alpha-2. Wenn Sie das Land nicht explizit angeben, wird es anhand der IP-Adresse des Benutzers ermittelt.

Standard "US"
curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/44056/items/virtual_currency/package?limit=50&offset=0&locale=en&additional_fields%5B%5D=string&country=US' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Die Liste der virtuellen Währungspakete wurde erfolgreich empfangen.

Bodyapplication/json
itemsArray of objects(Catalog_inline_response_200_7_items)
Beispiel: [{"attributes":[],"bundle_type":"virtual_currency_package","content":[{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name first package","price":{"amount":"2.0000","amount_without_discount":"2.0000","currency":"USD"},"sku":"vc_package_1","type":"bundle","virtual_prices":[]},{"attributes":[],"bundle_type":"virtual_currency_package","content":[{"description":"description","image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1}},"name":"SHOTGUN FOR TRUE RAIDERS","quantity":200,"sku":"shotgun_raider","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name third package","price":{"amount":"4.0000","amount_without_discount":"4.0000","currency":"USD"},"sku":"vc_package_3","type":"bundle","virtual_prices":[]}]
items[].​attributesArray of objects(Catalog_client-attributes)

Liste der dem Spiel zugeordneten Attribute und deren Werte.

Achtung: Dieser Teil der Antwort ist nur verfügbar, wenn Sie den Abfrageparameter "additional_fields[]=attributes" senden.
Standard []
items[].​attributes[].​external_idstring(Catalog_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(Catalog_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[].​bundle_typestring

Bundle-Typ: standard/virtual_currency_package.

Beispiel: "virtual_currency_package"
items[].​contentArray of objects(Catalog_inline_response_200_7_content)

Inhalt des virtuellen Währungspakets.

Beispiel: [{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}]
items[].​content[].​descriptionstring

Artikelbeschreibung.

Beispiel: "Big Rocket - description"
items[].​content[].​image_urlstring

Bild-URL.

Beispiel: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"
items[].​content[].​inventory_optionsobject(Catalog_inline_response_200_7_inventory_options)

Definiert die Inventarartikeloptionen.

items[].​content[].​inventory_options.​consumableobject or null(Catalog_inline_response_200_5_inventory_options_consumable)

Definiert die Eigenschaften, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

items[].​content[].​inventory_options.​consumable.​usages_countinteger or null

Gesamtzahl der verbleibenden Nutzungsmöglichkeiten, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

Beispiel: 1
items[].​content[].​inventory_options.​expiration_periodobject or null(Catalog_inline_response_200_7_inventory_options_expiration_period)

Definiert die Eigenschaften, sofern es sich um einen zeitlich begrenzten Gegenstand handelt. Wenn es sich um einen nicht zeitlich begrenzten Gegenstand handelt lautet der Wert null.

items[].​content[].​inventory_options.​expiration_period.​typestring

Definiert die Art des Artikelablaufs.

Enum"minute""hour""day""week""month""year"
Beispiel: "day"
items[].​content[].​inventory_options.​expiration_period.​valueinteger

Definiert den Wert für den Ablaufzeitraum.

Beispiel: 1
items[].​content[].​namestring

Artikelname.

Beispiel: "Big Rocket"
items[].​content[].​quantityinteger

Menge der virtuellen Währung in einem Paket.

Beispiel: 250
items[].​content[].​skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Bindestriche und Unterstriche enthalten.

Beispiel: "big_rocket"
items[].​content[].​typestring

Artikeltyp: virtual_good/virtual_currency/bundle.

Beispiel: "virtual_currency"
items[].​descriptionstring

Artikelbeschreibung.

Beispiel: "Big Rocket - description"
items[].​groupsArray of objects(Catalog_inline_response_200_groups)

Gruppen, zu denen der Artikel gehört.

Beispiel: [{"external_id":"accessory","name":"Accessory"}]
items[].​groups[].​external_idstring
Beispiel: "accessory"
items[].​groups[].​namestring
Beispiel: "Accessory"
items[].​image_urlstring

Bild-URL.

Beispiel: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"
items[].​is_freestring

Ist true festgelegt, ist der Artikel kostenlos.

Beispiel: "false"
items[].​namestring

Artikelname.

Beispiel: "Big Rocket"
items[].​priceobject(Catalog_inline_response_200_5_price)

Artikelpreise.

items[].​price.​amountstring

Rabattierter Artikelpreis.

Beispiel: "100.99"
items[].​price.​amount_without_discountstring

Artikelpreis.

Beispiel: "100.99"
items[].​price.​currencystring

Standardkaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
items[].​skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

Beispiel: "big_rocket"
items[].​typestring

Artikeltyp: virtual_good/virtual_currency/bundle.

Beispiel: "bundle"
items[].​virtual_pricesArray of objects(Catalog_inline_response_200_virtual_prices)

Virtuelle Preise.

items[].​virtual_prices[].​amountinteger

Rabattierter Artikelpreis in virtueller Währung.

Beispiel: 100
items[].​virtual_prices[].​amount_without_discountinteger

Artikelpreis.

Beispiel: 200
items[].​virtual_prices[].​descriptionstring

Beschreibung der virtuellen Währung.

Beispiel: "Big Rocket - description"
items[].​virtual_prices[].​image_urlstring

Bild der virtuellen Währung.

Beispiel: "http://image.png"
items[].​virtual_prices[].​is_defaultboolean

Ob der Preis für den Artikel voreingestellt ist.

Beispiel: true
items[].​virtual_prices[].​namestring

Name der virtuellen Währung.

Beispiel: "SHOTGUN FOR TRUE RAIDERS"
items[].​virtual_prices[].​skustring

Artikel-SKU der virtuellen Währung.

Beispiel: "vc_test"
items[].​virtual_prices[].​typestring

Typ der virtuellen Währung.

Beispiel: "virtual_currency"
Antwort
application/json
{
  "items": [
    { … },
    { … }
  ]
}

Liste der virtuellen Gegenstände abrufen

Anfrage

Ruft eine Liste von virtuellen Gegenständen zum Erstellen eines Katalogs ab.

Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen.
Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
Abfrage
limitinteger

Obergrenze der Elementanzahl auf der Seite.

Beispiel: limit=50
offsetinteger

Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

Beispiel: offset=0
localestring

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

Standard "en"
additional_fields[]Array of strings

Die Liste der zusätzlichen Felder. Diese Felder werden in der Antwort angezeigt, sofern sie in der Anfrage gesendet werden. Verfügbare Felder: media_list, order, long_description.

countrystring

Land, für das regionale Preise berechnet und Katalogeinschränkungen festgelegt werden. Ländercode, bestehend aus zwei Großbuchstaben, gemäß ISO 3166-1 Alpha-2. Wenn Sie das Land nicht explizit angeben, wird es anhand der IP-Adresse des Benutzers ermittelt.

Standard "US"
curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/44056/items/virtual_items?limit=50&offset=0&locale=en&additional_fields%5B%5D=string&country=US' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Die Liste der virtuelle Gegenstände wurde erfolgreich empfangen.

Bodyapplication/json
itemsArray of objects(Catalog_inline_response_200_5_items)
Beispiel: [{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"external_id":"size_e3364991f92e751689a68b96598a5a5a84010b85","value":"5"}]}],"description":"Big Rocket - description","groups":[{"external_id":"accessory","name":"Accessory"}],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"Big Rocket","price":{"amount":"100.99","amount_without_discount":"100.99","currency":"USD"},"sku":"big_rocket","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"}]},{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"external_id":"size_e3364991f92e751689a68b96598a5a5a84010b85","value":"5"}]},{"external_id":"rating","name":"Rating","values":[{"external_id":"rating_e3364991f92e751689a68b96598a5a5a84010b85","value":"3.9"}]}],"description":"description","groups":[{"external_id":"hair","name":"Hair"}],"image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"SHOTGUN FOR TRUE RAIDERS","price":{"amount":"101.0","amount_without_discount":"101.0","currency":"USD"},"sku":"shotgun_raider","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"},{"amount":200,"amount_without_discount":200,"description":"description","image_url":"http://image.png","is_default":false,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test_2","type":"virtual_currency"}]},{"attributes":[],"description":"description","groups":[],"image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"shotgun_raider_2","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[]}]
items[].​attributesArray of objects(Catalog_client-attributes)

Liste der dem Spiel zugeordneten Attribute und deren Werte.

Achtung: Dieser Teil der Antwort ist nur verfügbar, wenn Sie den Abfrageparameter "additional_fields[]=attributes" senden.
Standard []
items[].​attributes[].​external_idstring(Catalog_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(Catalog_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

Artikelbeschreibung.

Beispiel: "Big Rocket - description"
items[].​groupsArray of objects(Catalog_inline_response_200_groups)

Gruppen, zu denen der Artikel gehört.

Beispiel: [{"external_id":"accessory","name":"Accessory"}]
items[].​groups[].​external_idstring
Beispiel: "accessory"
items[].​groups[].​namestring
Beispiel: "Accessory"
items[].​image_urlstring

Bild-URL.

Beispiel: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"
items[].​inventory_optionsobject(Catalog_inline_response_200_5_inventory_options)

Definiert die Inventarartikeloptionen.

items[].​inventory_options.​consumableobject or null(Catalog_inline_response_200_5_inventory_options_consumable)

Definiert die Eigenschaften, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

items[].​inventory_options.​consumable.​usages_countinteger or null

Gesamtzahl der verbleibenden Nutzungsmöglichkeiten, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

Beispiel: 1
items[].​inventory_options.​expiration_periodobject or null(Catalog_inline_response_200_5_inventory_options_expiration_period)

Definiert die Eigenschaften, sofern es sich um einen zeitlich begrenzten Gegenstand handelt. Wenn es sich um einen nicht zeitlich begrenzten Gegenstand handelt lautet der Wert null.

items[].​inventory_options.​expiration_period.​typestring

Definiert die Art des Artikelablaufs.

Enum"minute""hour""day""week""month""year"
Beispiel: "day"
items[].​inventory_options.​expiration_period.​valueinteger

Definiert einen Wert für den Ablaufzeitraum.

Beispiel: 1
items[].​is_freeboolean

Ist true festgelegt, ist der Artikel kostenlos.

Beispiel: false
items[].​namestring

Artikelname.

Beispiel: "Big Rocket"
items[].​priceobject(Catalog_inline_response_200_5_price)

Artikelpreise.

items[].​price.​amountstring

Rabattierter Artikelpreis.

Beispiel: "100.99"
items[].​price.​amount_without_discountstring

Artikelpreis.

Beispiel: "100.99"
items[].​price.​currencystring

Standardkaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
items[].​skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

Beispiel: "big_rocket"
items[].​typestring

Artikeltyp: virtual_good/virtual_currency/bundle.

Beispiel: "virtual_good"
items[].​virtual_item_typestring

Typ des virtuelle Gegenstands.

Enum"consumable""non_consumable""non_renewing_subscription"
Beispiel: "non-consumable"
items[].​virtual_pricesArray of objects(Catalog_inline_response_200_virtual_prices)

Virtuelle Preise.

items[].​virtual_prices[].​amountinteger

Rabattierter Artikelpreis in virtueller Währung.

Beispiel: 100
items[].​virtual_prices[].​amount_without_discountinteger

Artikelpreis.

Beispiel: 200
items[].​virtual_prices[].​descriptionstring

Beschreibung der virtuellen Währung.

Beispiel: "Big Rocket - description"
items[].​virtual_prices[].​image_urlstring

Bild der virtuellen Währung.

Beispiel: "http://image.png"
items[].​virtual_prices[].​is_defaultboolean

Ob der Preis für den Artikel voreingestellt ist.

Beispiel: true
items[].​virtual_prices[].​namestring

Name der virtuellen Währung.

Beispiel: "SHOTGUN FOR TRUE RAIDERS"
items[].​virtual_prices[].​skustring

Artikel-SKU der virtuellen Währung.

Beispiel: "vc_test"
items[].​virtual_prices[].​typestring

Typ der virtuellen Währung.

Beispiel: "virtual_currency"
Antwort
application/json
{
  "items": [
    { … },
    { … },
    { … }
  ]
}

Artikelliste anhand von angegebener Gruppe abrufen

Anfrage

Ruft eine Artikelliste aus der angegebenen Gruppe zum Erstellen eines Katalogs ab.

Achtung: Bei allen Projekten ist die Anzahl der pro Antwort abrufbaren Elemente begrenzt. Der Standard- und Maximalwert beträgt 50 Elemente pro Antwort. Verwenden Sie die Felder limit und offset, um mehr Daten pro Seite abzurufen.
Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
external_idstringerforderlich

external ID der Gruppe.

Standard "all"
Abfrage
limitinteger

Obergrenze der Elementanzahl auf der Seite.

Beispiel: limit=50
offsetinteger

Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

Beispiel: offset=0
localestring

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

Standard "en"
additional_fields[]Array of strings

Die Liste der zusätzlichen Felder. Diese Felder werden in der Antwort angezeigt, sofern sie in der Anfrage gesendet werden. Verfügbare Felder: media_list, order, long_description.

countrystring

Land, für das regionale Preise berechnet und Katalogeinschränkungen festgelegt werden. Ländercode, bestehend aus zwei Großbuchstaben, gemäß ISO 3166-1 Alpha-2. Wenn Sie das Land nicht explizit angeben, wird es anhand der IP-Adresse des Benutzers ermittelt.

Standard "US"
curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/44056/items/virtual_items/group/{external_id}?limit=50&offset=0&locale=en&additional_fields%5B%5D=string&country=US' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Die Liste der Artikel aus der angegebenen Gruppe wurde erfolgreich empfangen.

Bodyapplication/json
itemsArray of objects(Catalog_inline_response_200_8_items)
Beispiel: [{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"value":"5"}]}],"description":"Big Rocket - description","groups":[{"external_id":"accessory","name":"Accessory"}],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"Big Rocket","price":{"amount":"100.99","amount_without_discount":"100.99","currency":"USD"},"sku":"big_rocket","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"}]},{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"value":"5"}]},{"external_id":"rating","name":"Rating","values":[{"value":"3.9"}]},{"external_id":"genre","name":"Genre","values":[{"value":"Strategy"},{"value":"Tactical"},"Turn-based"]}],"description":"description","groups":[{"external_id":"accessory","name":"Accessory"}],"image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"SHOTGUN FOR TRUE RAIDERS","price":{"amount":"101.0","amount_without_discount":"101.0","currency":"USD"},"sku":"shotgun_raider","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"},{"amount":200,"amount_without_discount":200,"description":"description","image_url":"http://image.png","is_default":false,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test_2","type":"virtual_currency"}]}]
items[].​attributesArray of objects(Catalog_client-attributes)

Liste der dem Spiel zugeordneten Attribute und deren Werte.

Achtung: Dieser Teil der Antwort ist nur verfügbar, wenn Sie den Abfrageparameter "additional_fields[]=attributes" senden.
Standard []
items[].​attributes[].​external_idstring(Catalog_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(Catalog_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

Artikelbeschreibung.

Beispiel: "Big Rocket - description"
items[].​groupsArray of objects(Catalog_inline_response_200_groups)

Gruppen, zu denen der Artikel gehört.

Beispiel: [{"external_id":"accessory","name":"Accessory"}]
items[].​groups[].​external_idstring
Beispiel: "accessory"
items[].​groups[].​namestring
Beispiel: "Accessory"
items[].​image_urlstring

Bild-URL.

Beispiel: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"
items[].​inventory_optionsobject(Catalog_inline_response_200_7_inventory_options)

Definiert die Inventarartikeloptionen.

items[].​inventory_options.​consumableobject or null(Catalog_inline_response_200_5_inventory_options_consumable)

Definiert die Eigenschaften, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

items[].​inventory_options.​consumable.​usages_countinteger or null

Gesamtzahl der verbleibenden Nutzungsmöglichkeiten, sofern es sich um einen Gebrauchsgegenstand handelt. Wenn es sich um einen nicht aufbrauchbaren Gegenstand handelt lautet der Wert null.

Beispiel: 1
items[].​inventory_options.​expiration_periodobject or null(Catalog_inline_response_200_7_inventory_options_expiration_period)

Definiert die Eigenschaften, sofern es sich um einen zeitlich begrenzten Gegenstand handelt. Wenn es sich um einen nicht zeitlich begrenzten Gegenstand handelt lautet der Wert null.

items[].​inventory_options.​expiration_period.​typestring

Definiert die Art des Artikelablaufs.

Enum"minute""hour""day""week""month""year"
Beispiel: "day"
items[].​inventory_options.​expiration_period.​valueinteger

Definiert den Wert für den Ablaufzeitraum.

Beispiel: 1
items[].​is_freestring

Ist true festgelegt, ist der Artikel kostenlos.

Beispiel: "false"
items[].​namestring

Artikelname.

Beispiel: "Big Rocket"
items[].​priceobject(Catalog_inline_response_200_5_price)

Artikelpreise.

items[].​price.​amountstring

Rabattierter Artikelpreis.

Beispiel: "100.99"
items[].​price.​amount_without_discountstring

Artikelpreis.

Beispiel: "100.99"
items[].​price.​currencystring

Standardkaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
items[].​skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

Beispiel: "big_rocket"
items[].​typestring

Artikeltyp: consumable/expiration/permanent/lootboxes/physical.

Beispiel: "virtual_good"
items[].​virtual_item_typestring

Typ des virtuelle Gegenstands.

Enum"consumable""non_consumable""non_renewing_subscription"
Beispiel: "non_consumable"
items[].​virtual_pricesArray of objects(Catalog_inline_response_200_8_virtual_prices)

Virtuelle Preise.

items[].​virtual_prices[].​amountinteger

Rabattierter Artikelpreis in virtueller Währung.

Beispiel: 100
items[].​virtual_prices[].​amount_without_discountinteger

Artikelpreis.

Beispiel: 200
items[].​virtual_prices[].​descriptionstring

Beschreibung der virtuellen Währung.

Beispiel: "Big Rocket - description"
items[].​virtual_prices[].​image_urlstring
Beispiel: "http://image.png"
items[].​virtual_prices[].​is_defaultboolean

Ob der Preis für einen Artikel voreingestellt ist.

Beispiel: true
items[].​virtual_prices[].​namestring

Name der virtuellen Währung.

Beispiel: "SHOTGUN FOR TRUE RAIDERS"
items[].​virtual_prices[].​skustring

Artikel-SKU der virtuellen Währung.

Beispiel: "vc_test"
items[].​virtual_prices[].​typestring

Typ der virtuellen Währung.

Beispiel: "virtual_currency"
Antwort
application/json
{
  "items": [
    { … },
    { … }
  ]
}

Bundles

Operationen

Benutzertoken

Operationen

Benachrichtigungen

Operationen

Bestellung

Operationen