Xsolla-logo

Artikelliste anhand angegebener Gruppe abrufen

get/v2/project/{project_id}/items/virtual_items/group/{external_id}

Ruft eine Artikelliste aus einer angegebenen Gruppe ab, um einen Katalog zu erstellen.

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": [
    ]
}