Artikelliste anhand angegebener Gruppe abrufen

Achtung

Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie erhalten können in der Antwort. Der Standard- und Höchstwert beträgt 50 Artikel pro Antwort. Um Seite für Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset.

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 Benutzerlimits und Werbeaktionen) angereichert und sorgt so für ein personalisiertes Ergebnis.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
external_id required	string Default: "all" Externe ID der Gruppe.

query Parameters

limit	integer Begrenzung der Elementanzahl auf der Seite. Example: limit=50
offset	integer Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0). Example: offset=0
locale	string Default: "en" Antwortsprache. Sprachcode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1.
additional_fields[]	Array of strings Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, wenn Sie sie in Ihrer Anfrage senden. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Ländercode bestehend aus zwei Großbuchstaben gemäß ISO 3166-1 ALPHA-2. Zeigt regionale Preise und Beschränkungen für einen Katalog an, sofern diese beim Erstellen eines Artikels angegeben wurden. Hinweis Wenn Sie das Land nicht explizit angeben, wird es basierend auf der IP-Adresse des Benutzers festgelegt. Example: country=US
promo_code	string [ 1 .. 128 ] characters Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 Zeigt zeitlich begrenzte Artikel an, die nicht erhältlich sind. Der Gültigkeitszeitraum dieser Artikel hat noch nicht begonnen oder ist bereits vorüber. Example: show_inactive_time_limited_items=1

Responses

200

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

404

Die Gruppe wurde nicht gefunden. Prüfen Sie, ob die external_id korrekt ist und die Gruppe nicht deaktiviert oder gelöscht wurde.

Request samples

Response samples

application/json

{"has_more": false,
"items": [{"attributes": [{"external_id": "stack_size",
"name": "Stack size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
}
],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Big Rocket - description",
"groups": [{"external_id": "weapons",
"name": {"en": "weapons"
}
}
],
"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,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Big Rocket",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "100.99",
"amount_without_discount": "100.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"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"
}
],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "value_point_1"
}
]
},
{"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"
}
]
}
],
"can_be_bought": true,
"description": "description",
"groups": [{"external_id": "weapons",
"name": {"en": "weapons"
}
}
],
"image_url": "http://image.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": {"type": "day",
"value": 1
}
},
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "SHOTGUN FOR TRUE RAIDERS",
"periods": [ ],
"price": {"amount": "101.0",
"amount_without_discount": "101.0",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"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"
}
],
"vp_rewards": [ ]
}
]
}