将游戏加入到目录

Xsolla Developers

或

将游戏加入到目录Client-side

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

Gets a game for the catalog.

Note

This endpoint, accessible without authorization, returns generic data. However, authorization enriches the response with user-specific details for a personalized result, such as available user limits and promotions.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer 项目ID。您可以在您的发布商帐户项目名称旁边找到。 Example: 44056
item_sku required	string Default: "full_game_1" 商品SKU。

query Parameters

locale	string Default: "en" 响应语言。按照ISO 639-1规定使用两个小写字母的语言代码。
additional_fields[]	Array of strings 附加字段列表。如果在请求中发送这些字段，则它们将包含在响应中。 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 区分大小写的唯一券码。包含字母和数字。 Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 显示用户不可用的时效性商品。此类商品的有效期尚未开始或已过期。 Example: show_inactive_time_limited_items=1

Responses

200

成功收到游戏。

404

未找到游戏。

Request samples

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

{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "9c5774997fc072b973bd5c231075c13841413f62",
"value": "Casual, Logic"
}
]
}
],
"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",
"promotions": [ ],
"sku": "com.xsolla.game_1",
"type": "unit",
"unit_items": [{"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"has_keys": true,
"is_free": false,
"is_pre_order": true,
"limits": null,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"promotions": [ ],
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "com.xsolla.game_key_01",
"type": "game_key",
"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"
}
]
},
{"can_be_bought": true,
"drm_name": "Origin",
"drm_sku": "origin_key_1",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"limits": null,
"periods": [ ],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"promotions": [ ],
"release_date": null,
"sku": "com.xsolla.game_key_02",
"type": "game_key",
"virtual_prices": [ ],
"vp_rewards": [ ]
}
],
"unit_type": "game"
}

将游戏加入到目录Client-side

path Parameters

query Parameters

We respect your privacy