Liste der Bundles anhand der angegebenen Gruppe abrufen

Xsolla Developers

oder

Liste der Bundles anhand der angegebenen Gruppe abrufenClient-side

get/v2/project/{project_id}/items/bundle/group/{external_id}

Gets a list of bundles within a group for building a catalog.

Attention

All projects have the limitation to the number of items that you can get in the response. The default and maximum value is 50 items per response.

Note

In general, the use of catalog of items is available without authorization.
Only authorized users can get a personalized catalog.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
external_id required	string Default: "all" 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, sofern Sie diese in der Anfrage senden. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla and the process of determining the country. 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 Bundles wurde erfolgreich empfangen.

Request samples

curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/{project_id}/items/bundle/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>'

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Casual"
},
{"external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
"value": "Strategy"
},
{"external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
"value": "Mobile"
}
]
}
],
"bundle_type": "standard",
"can_be_bought": true,
"content": [{"attributes": [{"external_id": "size",
"name": "Size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Large"
}
]
}
],
"description": "Big Rocket - short description.",
"groups": [ ],
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Big Rocket",
"price": {"amount": "10.99",
"amount_without_discount": "10.99",
"currency": "USD"
},
"quantity": 100,
"sku": "com.xsolla.big_rocket_1",
"type": "virtual_currency",
"virtual_item_type": "non_consumable",
"virtual_prices": [ ]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "pricePoint_44056_1",
"groups": [ ],
"image_url": null,
"is_free": false,
"item_id": 61031,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"long_description": null,
"media_list": [ ],
"name": "kg_10.00_bundle",
"order": 999,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"promotions": [ ],
"sku": "com.xsolla.kg_1",
"total_content_price": {"amount": "10.99",
"amount_without_discount": "10.99",
"currency": "USD"
},
"type": "bundle",
"virtual_prices": [ ],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "com.xsolla.value_point_1"
},
{"amount": 50,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_clan": true,
"item_id": 186321,
"name": "Clan Reward VP 1",
"sku": "com.xsolla.clan_value_point_1"
}
]
}
]
}