Xsolla-logo

Liste virtueller Gegenstände abrufenClient-side

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

Ruft eine Liste virtueller Gegenstände ab, um einen Katalog zu erstellen.

Achtung

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

Hinweis

Im Allgemeinen ist die Nutzung des Artikelkatalogs ohne Autorisierung möglich.
Nur autorisierte Benutzer kommen in den Genuss eines personalisierten Katalogs.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

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

Example: 44056
query Parameters
limit
integer

Limit for the number of elements on the page.

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

The list of additional fields. These fields will be in the response if you send them in your request.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

Two-letter uppercase country code per ISO 3166-1 alpha-2. Shows regional prices and restrictions for a catalog if those were specified while creating an item.

Note

If you do not specify the country explicitly, it will be set based on user's IP address.

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 virtuelle Gegenstände wurde erfolgreich empfangen.

Request samples
Response samples
application/json
{
  • "has_more": true,
  • "items": [
    ]
}