# Liste virtueller Gegenstände abrufen Ruft die Liste der virtuellen Gegenstände innerhalb eines Projekts zur Verwaltung ab. HinweisVerwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs. Endpoint: GET /v2/project/{project_id}/admin/items/virtual_items Version: 2.0.0 Security: basicAuth ## Path parameters: - `project_id` (integer, required) Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/. Example: 44056 ## Query parameters: - `limit` (integer) Begrenzung der Elementanzahl auf der Seite. Example: 50 - `offset` (integer) Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0). ## Response 200 fields (application/json): - `has_more` (boolean) Dient als Indikator dafür, dass weitere Seiten vorhanden sind. - `total_items_count` (integer) Gesamtzahl der Artikel im System. - `items` (array) - `items.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. - `items.attributes` (array) Liste der Attribute. Example: [{"external_id":"attribute_external_id","name":{"en":"Attribute name","de":"Attributname"},"values":[{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]}] - `items.attributes.external_id` (string, required) Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten. Example: "attribute_external_id" - `items.attributes.name` (object) Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert. Example: {"en":"Attribute name","de":"Attributname"} - `items.attributes.values` (array, required) Example: [{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}] - `items.attributes.values.external_id` (string, required) Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten. Example: "value_external_id" - `items.attributes.values.value` (object, required) Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert. - `items.name` (object,null) Objekt mit Lokalisierungen für Artikelnamen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/). - `items.description` (object,null) Objekt mit Lokalisierungen für Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/). - `items.long_description` (object,null) Objekt mit Lokalisierungen für lange Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Varianten angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der [Dokumentation](/de/doc/shop-builder/references/supported-languages/). - `items.groups` (array) Gruppen, zu denen der Artikel gehört. - `items.groups.external_id` (string) Example: "horror" - `items.groups.name` (object) Name des Artikels. Sollte Schlüssel-Wert-Paare enthalten, wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}" und der Wert ein String ist. Example: {"en":"Horror","de":"Horror"} - `items.media_list` (array) Zusätzliche Medieninhalte des Artikels wie Screenshots, Gameplay-Videos usw. - `items.media_list.type` (string) Medieninhaltstyp: image/video. Enum: "image", "video" - `items.media_list.url` (string) Ressourcendatei. Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg" - `items.type` (string) Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit. - `items.prices` (array) Example: [{"currency":"USD","amount":10.5,"is_default":true,"is_enabled":true}] - `items.prices.amount` (number, required) Betrag. Example: 10.5 - `items.prices.currency` (string, required) Währung des Artikelpreises. Dreistelliger Code pro [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu [Von Xsolla unterstützte Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/). Example: "USD" - `items.prices.country_iso` (string) Zweistelliger Ländercode in Großbuchstaben gemäß [ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Weitere Informationen zu den [von Xsolla unterstützten Ländern](https://developers.xsolla.com/de/doc/shop-builder/references/supported-countries/) finden Sie in der Dokumentation.Beispiel: country=US Example: "US" - `items.prices.is_default` (boolean) Example: true - `items.prices.is_enabled` (boolean) Example: true - `items.vc_prices` (array) Example: [{"sku":"com.xsolla.gold_1","amount":10,"is_default":true}] - `items.vc_prices.sku` (string, required) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "com.xsolla.gold_1" - `items.vc_prices.amount` (number, required) Betrag. Example: 10 - `items.vc_prices.is_default` (boolean) Example: true - `items.image_url` (string) Bild-URL. Damit das Bild im Zahlungsportal korrekt angezeigt und schnell geladen wird, beachten Sie bitte unsere Richtlinien für Bilder und URLs:Unterstützte Formate: WebP (empfohlen), PNG, JPG.Dateigröße: ≤ 50 kB (für WebP) oder ≤ 150 kB (für PNG und JPG).Bildgröße: 280 x 280 px.Farbraum: sRGB.Protokoll: HTTPS mit langlebigem Caching für versionierte URLs. - `items.is_free` (boolean) Ob der Artikel kostenlos ist. - `items.is_paid_randomized_reward` (boolean) Ob der Artikel eine kostenpflichtige zufällige Belohnung ist, z. B. eine Lootbox. - `items.order` (integer) Reihenfolge, in der die Artikel im Katalog angezeigt werden. Je höher der Wert, desto weiter unten erscheint der Artikel in der Liste. Bei gleichen Werten werden die Artikel nach Erstellungsdatum sortiert, wobei neuere Artikel weiter oben angezeigt werden. - `items.is_enabled` (boolean) Ob der Artikel verfügbar ist. Falls false festgelegt ist, kann der Artikel weder im Shop erworben noch als Teil eines Bundles oder im Rahmen einer Marketingkampagne bezogen werden. Ausführliche Informationen zur Verfügbarkeit von Artikeln finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/items-availability/). - `items.is_show_in_store` (boolean) Ob der Artikel im Katalog angezeigt wird. Wenn false und is_enabled: true festgelegt ist, ist der Artikel im Katalog nicht sichtbar, kann jedoch als Teil eines Bundles oder im Rahmen von Marketingkampagnen bezogen werden. Ausführliche Informationen zur Verfügbarkeit von Artikeln finden Sie in unserer [Dokumentation](https://developers.xsolla.com/de/items-catalog/catalog-features/items-availability/). - `items.regions` (array) Array der Regionen, in denen der Artikel erhältlich ist. Ist das Array leer oder wird es nicht übermittelt, ist der Artikel in allen Regionen erhältlich. - `items.regions.id` (integer) Regions-ID innerhalb des Projekts. Ausführliche Informationen finden Sie in der [Dokumentation zu den regionalen Verkaufsbeschränkungen](https://developers.xsolla.com/de/items-catalog/catalog-features/regional-restrictions/) sowie in den [API-Aufrufen zur Regionsverwaltung](https://developers.xsolla.com/de/api/catalog/common-regions). Example: 1 - `items.limits` (object,null) Artikelbeschränkungen. - `items.limits.per_user` (object,null) Artikelbeschränkung für einen separaten Nutzer. - `items.limits.per_user.total` (integer) Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann. - `items.limits.per_user.limit_exceeded_visibility` (string) Steuert die Sichtbarkeit des Artikels im Katalog nach Erreichen des Kauflimits, und zwar bis das Limit das nächste Mal zurückgesetzt wird. Gilt für Artikel, bei denen im Array recurrent_schedule Limits konfiguriert sind, die regelmäßig zurückgesetzt werden. Wenn festgelegt ist, dass das Kauflimit nicht zurückgesetzt wird, wird der Artikel nach Erreichen des Kauflimits nicht mehr im Katalog angezeigt, unabhängig davon, welcher Wert für limit_exceeded_visibility festgelegt ist. Mögliche Wert: - show – Der Artikel wird in API-Aufrufen zur Katalogabfrage zurückgegeben, auch wenn das Kauflimit bereits erreicht wurde. Bei clientseitigen API-Aufrufen zur Katalogabfrage wird der Artikel nach Erreichen des Limits mit dem Flag can_be_bought: false zurückgegeben. Das Datum, an dem das Limit das nächste Mal zurückgesetzt wird, wird im Parameter reset_next_date zurückgegeben. - hide – nachdem das Kauflimit erreicht wurde, wird der Artikel bei API-Aufrufen zur Katalogabfrage nicht mehr zurückgegeben, bis das Limit zurückgesetzt wird. Enum: "show", "hide" - `items.limits.per_item` (object,null) Globale Artikelbeschränkung. - `items.limits.per_item.total` (integer) Höchstzahl von Artikeln, die alle Nutzer kaufen können. - `items.limits.per_item.available` (integer) Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können. - `items.limits.per_item.reserved` (integer) - `items.limits.per_item.sold` (integer) - `items.limits.recurrent_schedule` (object,null) Aktualisierungszeitraum begrenzen. - `items.limits.recurrent_schedule.per_user` (any) Aktualisierungszeitraum für das Nutzerlimit. - `items.periods` (array) Artikelangebotszeitraum. - `items.periods.date_from` (string,null) Datum, an dem der angegebene Artikel zum Verkauf angeboten wird. Example: "2020-08-11T10:00:00+03:00" - `items.periods.date_until` (string,null) Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: null. Example: "2020-08-11T20:00:00+03:00" - `items.custom_attributes` (object) Ein JSON-Objekt mit Artikelattributen und ‑werten. ## Response 401 fields (application/json): - `statusCode` (integer) Example: 401 - `errorCode` (integer) Example: 1020 - `errorMessage` (string) Example: "[0401-1020]: Error in Authentication method occurred"