获取游戏列表

get/v2/project/{project_id}/items/game

获取用于构建目录的游戏列表。

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

SecurityAuthForClient

Request

path Parameters

project_id

required

integer

项目ID。

Example: 44056

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 附加字段列表。如果在请求中发送这些字段，则它们将包含在响应中。可用字段`media_list`、`order`、`long_description`。
country	string Default: "US" 对于该目录要计算区域价格和限制的国家/地区。符合ISO 3166-1 alpha-2的两个大写字母的国家/地区代码。如果未明确指定国家/地区，则将根据用户的IP地址进行计算。

Responses

200

游戏列表已成功接收。

Request samples

Response samples

application/json

{"items": [{"attributes": {"$ref": "#/components/examples/client-attribute-game/Catalog_value"
},
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
},
{"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_1",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": true,
"is_free": false,
"is_pre_order": true,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ]
},
{"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"sku": "game_key_02",
"type": "game_key",
"virtual_prices": [ ]
}
],
"unit_type": "game"
},
{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
}
],
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"sku": "game_2",
"type": "unit",
"unit_items": [{"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ]
}
],
"unit_type": "game"
}
]
}