カタログを作成するために、指定されたグループから販売可能なアイテムリストを取得します。
limit | integer Limit for the number of elements on the page. Example: limit=50 |
offset | integer リストが生成される要素番号(カウントは0から始まります)。 Example: offset=0 |
locale | string Default: "en" 応答言語。ISO 639-1に基づく小文字の2文字言語コード。 |
additional_fields[] | Array of strings 追加フィールドのリスト。これらのフィールドは、リクエストの中で送信すると、応答に含まれます。 |
country | string ISO 3166-1 alpha-2に従った2文字の大文字の国名コード。エクソーラがサポートする国と国を決定するプロセスの詳細情報については、ドキュメンテーションを確認してください。 Example: country=US |
promo_code | string [ 1 .. 128 ] characters 大文字と小文字を区別する一意のコードです。文字と数字が含まれます。 Example: promo_code=WINTER2021 |
show_inactive_time_limited_items | integer Default: 0 ユーザーに利用可能でない、期限付きアイテムを表示します。このようなアイテムの有効期間はまだ開始されていないか、すでに期限切れです。 Example: show_inactive_time_limited_items=1 |
指定されたグループの販売可能なアイテムのリストは正常に受信されました。
グループが見つかりませんでした。external_id
が正しく、グループがオフになったり削除されたりしていないことを確認してください。
curl -i -X GET \ 'https://store.xsolla.com/api/v2/project/{project_id}/items/group/{external_id}?limit=50&offset=0&locale=en&additional_fields%5B%5D=media_list&country=US&promo_code=WINTER2021&show_inactive_time_limited_items=1' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "has_more": true,
- "items": [
- {
- "attributes": [ ],
- "can_be_bought": true,
- "custom_attributes": {
- "attr": "value",
- "purchased": 0
}, - "description": "Electric shield",
- "groups": [
- {
- "external_id": "armour",
- "name": "Armour"
}
], - "inventory_options": {
- "consumable": null,
- "expiration_period": [
- {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "Royal shield",
- "groups": [
- {
- "external_id": "armour",
- "name": "Armour"
}
], - "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"
}, - "promotions": [ ],
- "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,
- "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,
- "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,
- "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"
}
], - "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"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "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,
- "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,
- "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,
- "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"
}
], - "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"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "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,
- "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,
- "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,
- "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"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "sku": "electric_shields",
- "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,
- "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,
- "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,
- "is_default": false,
- "item_id": 259767,
- "name": "Bronze",
- "sku": "bronze",
- "type": "virtual_currency"
}
], - "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "clan_value_point_sku_1"
}
]
}
]
}