Xsolla-logo
  • 文档
  • 创建帐户

按指定组获取可售商品列表

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

从指定组获取用于构建目录的可售商品列表。

注意：

所有项目对于可以在响应中获得的商品数量均都限制。默认值和最大值是每个响应50项。要逐页获取更多数据，请使用limit和offset字段。

注：

一般情况下，物品目录的使用无需授权。
只有授权用户才能获取个性化目录。
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 59080
external_id
required
string
Default: "armour"

组外部ID。

query Parameters
limit
integer

页面上元素数量的限制。

Example: limit=50
offset
integer

元素编号，从该元素开始生成列表（从0开始数）。

Example: offset=0
locale
string
Default: "en"

响应语言。按照ISO 639-1规定使用两个小写字母的语言代码。

additional_fields[]
Array of strings

附加字段列表。如果在请求中发送这些字段，则它们将包含在响应中。

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

符合ISO 3166-1 alpha-2标准的两个大写字母的国家/地区代码。如果在创建商品时进行了指定，则显示目录的区域价格和限制。

注意

如果没有明确指定国家/地区，则会根据用户的IP地址设置。

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
Responses
200

已成功接收指定组的可售商品列表。

404

未找到该组。确保external_id正确并且该组没有被关闭或删除。

Request samples 
Response samples 
application/json
{
  • "has_more": true,
  • "items": []
}
System statusAll services operational
Privacy Settings
Privacy PolicyEnd User License Agreement© 2006–2024 Xsolla Inc.