# Get virtual currency package list by specified group Retrieves a list of virtual currency packages from the specified group for building a catalog. AchtungBei 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 Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verwenden Sie die Autorisierung, um personalisierte Nutzerdaten abzurufen, wie z. B. mit dem Artikel verknüpfte Limits und Werbeaktionen. Dazu müssen Sie den Benutzer-JWT im Authorization-Header übermitteln. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit für diesen Aufruf. Endpoint: GET /v2/project/{project_id}/items/virtual_currency/package/group/{external_id} Version: 2.0.0 Security: XsollaLoginUserJWT ## 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 - `external_id` (string, required) External item group ID specified during creation. Example: "weapons" ## 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). - `locale` (string) Antwortsprache. Sprachencode bestehend aus zwei Kleinbuchstaben gemäß ISO 639-1 (zum Beispiel en). Fünfstellige Gebietsschemacodes (zum Beispiel en-US) werden in Lokalisierungsfeldern wie name und description unterstützt, jedoch in den Antworten in zweistellige Codes umgewandelt. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation. - `additional_fields[]` (array) Additional fields to include in the response. By default, these fields are not returned. Pass the required values to include them. Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group" - `country` (string) Zweistelliger Ländercode in Großbuchstaben gemäß ISO 3166-1 Alpha-2. Weitere Informationen zu den von Xsolla unterstützten Ländern und dazu, wie das Land ermittelt wird, finden Sie in der Dokumentation. Example: "US" - `promo_code` (string) Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: "WINTER2021" - `show_inactive_time_limited_items` (integer) 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: 1 ## Response 200 fields (application/json): - `has_more` (boolean) Dient als Indikator dafür, dass weitere Seiten vorhanden sind. - `items` (array) - `items.item_id` (integer) Unique item ID assigned by Xsolla. - `items.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "crystal-pack" - `items.name` (string) Artikelname. Example: "Crystal Pack" - `items.groups` (array) Gruppen, zu denen der Artikel gehört. - `items.groups.external_id` (string) [External item group ID](/de/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id) specified during creation. Example: "exclusive" - `items.groups.name` (string) Name der Gruppe. Example: "Exclusive" - `items.groups.item_order_in_group` (integer) The item's position within the group that determines its display order. Returned only if requested via the additional_fields[] query parameter. Example: 1 - `items.attributes` (array) Liste der Attribute und ihrer Werte, die dem Artikel zugeordnet sind. Kann für die Katalogfilterung verwendet werden. - `items.attributes.external_id` (string) Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten. - `items.attributes.name` (object) Name des Attributs. Example: "Genre" - `items.attributes.values` (array) - `items.attributes.values.external_id` (string) Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten. - `items.attributes.values.value` (string) Wert des Attributs. Example: "Strategy" - `items.type` (string) Artikeltyp: virtual_good/virtual_currency/bundle. Example: "bundle" - `items.bundle_type` (string) Bundle type. Always virtual_currency_package for virtual currency packages. Example: "virtual_currency_package" - `items.description` (string) Artikelbeschreibung. Example: "Crystal Pack Description" - `items.image_url` (string) Bild-URL. Example: "https://cdn.xsolla.net/items/crystal-pack.png" - `items.is_free` (boolean) Ob der Artikel kostenlos ist. - `items.price` (object) Artikelpreise. - `items.price.amount` (string) Reduzierter Artikelpreis. Example: "100.99" - `items.price.amount_without_discount` (string) Item price without discount. Example: "100.99" - `items.price.currency` (string) 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.virtual_prices` (array) Virtual prices. - `items.virtual_prices.amount` (integer) Artikelpreis in virtueller Währung. Example: 100 - `items.virtual_prices.amount_without_discount` (integer) Item price in virtual currency without discount. Always equal to amount since discounts are not applied to prices in virtual currency. Example: 200 - `items.virtual_prices.sku` (string) SKU der virtuellen Währung. Example: "vc_gold" - `items.virtual_prices.is_default` (boolean) Ob es sich um den Standardpreis in virtueller Währung handelt. Example: true - `items.virtual_prices.image_url` (string,null) Virtual currency image URL. Example: "http://image.png" - `items.virtual_prices.name` (string) Virtual currency name. Example: "Gold" - `items.virtual_prices.type` (string) Item type. For virtual currency, it is virtual_currency. Example: "virtual_currency" - `items.virtual_prices.description` (string,null) Virtual currency description. Example: "In-game currency used to purchase weapons and upgrades" - `items.can_be_bought` (boolean) Sofern true, kann der Nutzer einen Artikel kaufen. - `items.content` (array) Inhalt des virtuellen Währungspakets. Example: [{"description":"Crystal - short description","image_url":"https://cdn.xsolla.net/items/crystal-pack.png","sku":"com.xsolla.crystal_1","name":"Crystals","type":"virtual_currency","quantity":100}] - `items.content.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten. Example: "com.xsolla.crystal_1" - `items.content.quantity` (integer) Menge der virtuellen Währung im Paket. Example: 250 - `items.content.limits` (object,null) Artikelbeschränkungen. - `items.content.limits.per_user` (object,null) Artikelbeschränkungen für einen Nutzer. - `items.content.limits.per_user.total` (integer) Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann. Example: 5 - `items.content.limits.per_user.available` (integer) Verbleibende Anzahl von Artikeln, die der aktuelle Nutzer kaufen kann. Example: 3 - `items.content.limits.per_user.recurrent_schedule` (any) - `items.content.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.content.limits.per_item` (object,null) Artikelbeschränkungen für einen Artikel. - `items.content.limits.per_item.total` (integer) Höchstzahl von Artikeln, die alle Nutzer kaufen können. Example: 5 - `items.content.limits.per_item.available` (integer) Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können. Example: 3 - `items.promotions` (array) 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. - `items.promotions.name` (string) - `items.promotions.date_start` (string,null) - `items.promotions.date_end` (string,null) - `items.promotions.discount` (object,null) - `items.promotions.discount.percent` (string,null) - `items.promotions.discount.value` (string,null) - `items.promotions.bonus` (array) - `items.promotions.bonus.sku` (string) - `items.promotions.bonus.quantity` (integer) - `items.promotions.bonus.type` (string) Typ des Bonusartikels. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.promotions.bonus.name` (string) Name des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.promotions.bonus.image_url` (string) Bild-URL des Bonusartikels. Nicht verfügbar für Bonusartikel vom Typ physical_good. - `items.promotions.bonus.bundle_type` (string) Typ des im Bundle enthaltenen Bonusartikels. Nur verfügbar für Bonusartikel vom Typ bundle. Enum: "standard", "virtual_currency_package" - `items.promotions.limits` (object) - `items.promotions.limits.per_user` (object) - `items.promotions.limits.per_user.available` (integer) - `items.promotions.limits.per_user.total` (integer) - `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. - `items.vp_rewards` (array) List of value point rewards for the item. - `items.vp_rewards.item_id` (integer) Interne eindeutige Artikel-ID. - `items.vp_rewards.sku` (string) Eindeutige ID des Wertpunkts. - `items.vp_rewards.amount` (integer) Anzahl der Wertpunkte. - `items.vp_rewards.name` (string) Wertpunktname. - `items.vp_rewards.is_clan` (boolean) Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird. ## Response 404 fields (application/json): - `statusCode` (integer) HTTP response status code. Example: 404 - `errorCode` (integer) Xsolla error code Example: 4403 - `errorMessage` (string) Kurze Fehlerbeschreibung. Example: "[0401-4403]: Item group not found"