Xsolla-logoXsolla Developers
前往发布商帐户

获取可售商品列表Client-side

get/v2/project/{project_id}/items

Gets a sellable items list 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. To get more data page by page, use limit and offset fields.

Note

The use of the item catalog API calls is available without authorization, but to get a personalized catalog, you must pass the user JWT in the Authorization header.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

项目ID。您可以在您的发布商帐户项目名称旁边找到。

Example: 59080
query Parameters
limit
integer >= 1

页面上元素数量的限制。

Example: limit=50
offset
integer >= 0

元素编号,从该元素开始生成列表(从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" "item_order_in_group"
country
string

ISO 3166-1 alpha-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
Responses
200

已成功接收可售商品列表。

Request samples
Response samples
application/json
{
  • "has_more": false,
  • "items": [
    ]
}