# Virtuelles Währungspaket abrufen Ruft das virtuelle Wärhungspaket 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_currency/package/sku/{item_sku} Version: 2.0.0 Security: basicAuth ## Path parameters: - `project_id` (integer, required) Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 - `item_sku` (string, required) Artikel-SKU. Example: "booster_mega_1" ## Response 200 fields (application/json): - `attributes` (array) Liste der Attribute. Example: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]}] - `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_1" - `attributes.name` (object) Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert. Example: {"de":"Genre","en":"Genre"} - `attributes.values` (array, required) Example: [{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}] - `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: "attribute_value" - `attributes.values.value` (object, required) Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert. Example: {"de":"Strategie","en":"Strategy"} - `bundle_type` (string) Example: "virtual_currency_package" - `content` (array) - `content.image_url` (string) - `content.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/). - `content.quantity` (integer) - `content.sku` (string) Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten. Example: "booster_mega_1" - `custom_attributes` (object) Ein JSON-Objekt mit den Artikelattributen und ‑werten. Attribute ermöglichen es Ihnen, Artikeln weitere Informationen hinzuzufügen, z. B. das Mindestlevel des Spielers, um den Artikel verwenden zu können. Attribute bereichern die interne Logik Ihres Spiels und sind über spezielle GET-Methoden und Webhooks abrufbar. - `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/). - `groups` (array) Gruppen, zu denen der Artikel gehört. Example: [{"external_id":"horror","name":{"en":"Horror"}}] - `groups.external_id` (string) Example: "horror" - `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: {"de":"Horror","en":"Horror"} - `is_enabled` (boolean) - `is_free` (boolean) Ist true eingestellt, ist der Artikel kostenlos. - `is_show_in_store` (boolean) - `limits` (object,null) Artikelbeschränkungen. - `limits.per_item` (object,null) Globale Artikelbeschränkung. - `limits.per_item.available` (integer) Verbleibende Anzahl von Artikeln, die alle Nutzer kaufen können. - `limits.per_item.reserved` (integer) - `limits.per_item.sold` (integer) - `limits.per_item.total` (integer) Höchstzahl von Artikeln, die alle Nutzer kaufen können. - `limits.per_user` (object,null) Artikelbeschränkung für einen separaten Nutzer. - `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. Ist keine Zurücksetzung konfiguriert, wird der Artikel nach Erreichen des Kauflimits nicht im Katalog angezeigt, unabhängig vom Wert des Parameters limit_exceeded_visibility. Enum: "show", "hide" - `limits.per_user.total` (integer) Höchstzahl von Artikeln, die ein einzelner Nutzer kaufen kann. - `limits.recurrent_schedule` (object,null) Aktualisierungszeitraum begrenzen. - `limits.recurrent_schedule.per_user` (object,null) Aktualisierungszeitraum für das Nutzerlimit. - `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/). - `media_list` (array) Zusätzliche Medieninhalte des Artikels wie Screenshots, Gameplay-Videos usw. Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}] - `media_list.type` (string) Medieninhaltstyp: image/video. Enum: "image", "video" - `media_list.url` (string) Ressourcendatei. Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg" - `order` (integer) Definiert die Anordnungsreihenfolge. Example: 1 - `periods` (array) Artikelangebotszeitraum. - `periods.date_from` (string,null) Datum, an dem der angegebene Artikel zum Verkauf angeboten wird. Example: "2020-08-11T10:00:00+03:00" - `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" - `prices` (array) Example: [{"amount":10.5,"country_iso":"US","currency":"USD","is_default":true,"is_enabled":true}] - `prices.amount` (number, required) Betrag. Example: 10.5 - `prices.country_iso` (string,null) Land, in dem dieser Preis gilt. Code bestehend aus zwei Buchstaben gemäß [ISO 3166-1 Alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Example: "US" - `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" - `prices.is_default` (boolean) Example: true - `regions` (array) - `regions.id` (integer) Example: 1 - `type` (string) Artikeltyp: virtual_good/virtual_currency/bundle/physical_good/unit. - `vc_prices` (array) Example: [{"amount":10,"is_default":true,"sku":"com.xsolla.gold_1"}] ## Response 401 fields (application/json): - `errorCode` (integer) Example: 1020 - `errorMessage` (string) Example: "[0401-1020]: Error in Authentication method occurred" - `statusCode` (integer) Example: 401