Liste der verkäuflichen Artikel anhand von angegebener Gruppe abrufen

Hinweis

Auf diesen Endpunkt kann man ohne Autorisierung zugreifen, er gibt generische Daten zurück. Liegt eine Autorisierung vor, ist die Antwort jedoch mit benutzerspezifischen Details (z. B. vorhandene Nutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis.

Sicherheit

XsollaLoginUserJWT

Pfad

project_idintegererforderlich

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

Beispiel: 59080

item_idstringerforderlich

Artikel-ID.

Beispiel: 259774

Abfrage

promo_codestring[ 1 .. 128 ] characters

Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern.

Beispiel: promo_code=WINTER2021

show_inactive_time_limited_itemsinteger

Zeigt zeitlich begrenzte Artikel an, die nicht erhältlich sind. Der Gültigkeitszeitraum dieser Artikel hat noch nicht begonnen oder ist bereits vorüber.

Standard 0

Beispiel: show_inactive_time_limited_items=1

additional_fields[]Array of strings

Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, sofern Sie diese in der Anfrage senden.

Elemente Enum"media_list""order""long_description""custom_attributes""item_order_in_group"

curl -i -X GET \
  'https://xsolla.redocly.app/_mock/de/api/catalog/v2/project/59080/items/id/259774?promo_code=WINTER2021&show_inactive_time_limited_items=1&additional_fields%5B%5D=media_list' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Der verkäufliche Artikel wurde erfolgreich empfangen.

Bodyapplication/json

attributesArray of objects(Virtual-Items-Currency_client-attributes)

Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. 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"}]}}

can_be_boughtboolean

Sofern true, kann der Nutzer einen Artikel kaufen.

Beispiel: true

custom_attributesobject(json)(item-custom-attributes-response)

Ein JSON-Objekt mit Artikelattributen und ‑werten.

descriptionstring

Artikelbeschreibung.

Beispiel: "Electric shield"

groupsArray of objects(items_client_groups_response)

Gruppen, zu denen der Artikel gehört.

Standard []

Beispiel: [{"external_id":"exclusive","name":"Exclusive"}]

image_urlstring

Bild-URL.

Beispiel: "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png"

is_freeboolean(value-is_free)

Ist true eingestellt, ist der Artikel kostenlos.

Standard false

Beispiel: false

item_idinteger

Interne eindeutige Artikel-ID, die bei der Artikelerstellung vergeben wird.

Beispiel: 259774

limitsobject or null(Catalog_item_limits)

Artikelbeschränkungen.

namestring

Artikelname.

Beispiel: "Electric shield"

priceobject

Artikelpreise.

promotionsArray of objects(Catalog_item_promotions)

Auf bestimmte Artikel im Warenkorb angewandte Werbeaktionen. Das array wird in den folgenden Fällen zurückgegeben:

Für einen bestimmten Artikel ist eine Rabattaktion konfiguriert.
Ein Promocode mit der Einstellung Rabatt auf ausgewählte Artikel ist angewandt.

Werden keine Werbeaktionen auf Artikelebene angewandt, wird ein leeres Array zurückgegeben.

skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

Beispiel: "electric_shield"

typestring

Artikeltyp: virtual_good/virtual_currency/bundle/game_key/physical_good.

Enum"virtual_good""virtual_currency""bundle""game_key""physical_good"

Beispiel: "virtual_good"

virtual_item_typestring

Art des virtuellen Gegenstands.

Enum Wert	Beschreibung
consumable	Ein Artikel, der nach Gebrauch aus dem Inventar verschwindet (z. B. Munition).
non_consumable	Ein Artikel, der für unbegrenzte Zeit im Inventar verbleibt.
non_renewing_subscription	Zeitlich begrenzter Artikel, der den Zugang zu Diensten oder Inhalten für einen begrenzten Zeitraum ermöglicht.

Beispiel: "non-consumable"

virtual_pricesArray of objects

Virtuelle Preise.

vp_rewardsArray of objects(client-item-value-point-reward)

Wertpunktartikel-Belohnung.

Antwort

application/json

{
  "attributes": [],
  "can_be_bought": true,
  "custom_attributes": {
    "attr": "value",
    "purchased": 0
  },
  "description": "Electric shield",
  "groups": [
    { … }
  ],
  "image_url": "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png",
  "is_free": false,
  "item_id": 259774,
  "limits": {
    "per_user": { … }
  },
  "name": "Electric shield",
  "price": {
    "amount": "9.99",
    "amount_without_discount": "9.99",
    "currency": "USD"
  },
  "promotions": [
    { … }
  ],
  "sku": "com.xsolla.electric_shield_1",
  "type": "virtual_good",
  "virtual_item_type": "non_consumable",
  "virtual_prices": [
    { … },
    { … },
    { … }
  ],
  "vp_rewards": [
    { … },
    { … }
  ]
}