Rufen Sie die Liste der verkaufbaren Artikel nach angegebener Gruppe ab

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: 59080
external_id required	string Default: "armour" 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 verkaufbaren 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": true,
"items": [{"attributes": [ ],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Electric shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png",
"inventory_options": {"consumable": null,
"expiration_period": [{"attributes": [ ],
"can_be_bought": true,
"description": "Royal shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259775,
"name": "Royal shield",
"price": {"amount": "19.99",
"amount_without_discount": "19.99",
"currency": "USD"
},
"sku": "royal_shield",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 400,
"amount_without_discount": 400,
"calculated_price": {"amount": "400.00",
"amount_without_discount": "400.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Ancient helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259776,
"name": "Ancient helmet",
"price": {"amount": "1.99",
"amount_without_discount": "1.99",
"currency": "USD"
},
"sku": "ancient_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 4,
"amount_without_discount": 4,
"calculated_price": {"amount": "4.00",
"amount_without_discount": "4.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Wooden helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259777,
"name": "Wooden helmet",
"price": {"amount": "0.99",
"amount_without_discount": "0.99",
"currency": "USD"
},
"sku": "wooden_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 1,
"amount_without_discount": 1,
"calculated_price": {"amount": "1.00",
"amount_without_discount": "1.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
}
]
},
"is_free": false,
"item_id": 259774,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Electric shield",
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"sku": "electric_shield",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 10,
"amount_without_discount": 10,
"calculated_price": {"amount": "10.00",
"amount_without_discount": "10.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"calculated_price": {"amount": "200.00",
"amount_without_discount": "200.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "value_point_1"
}
]
}
]
}