Получение игры (admin)

Xsolla Developers

или

Личный кабинет

Получение игры (admin)Server-sideAdmin

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

Получает игру для администрирования. Игра состоит из игровых ключей, которые могут быть приобретены пользователем.

Примечание

Не используйте данный метод для построения каталога магазина.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта. Example: 44056
item_sku required	string Артикул товара. Example: booster_mega_1

query Parameters

promo_code

string [ 1 .. 128 ] characters

Уникальный код, чувствительный к регистру. Содержит буквы и цифры.

Example: promo_code=WINTER2021

Responses

200

Игра успешно получена.

401

Данные для базовой аутентификации не переданы или ошибочны. Убедитесь, что использовали базовую аутентификацию и проверьте правильность учетных данных.

404

Игра не найдена.

Request samples

curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/items/game/sku/{item_sku}?promo_code=WINTER2021'

Response samples

application/json

{"attributes": [{"external_id": "platform",
"name": {"en-US": "Platform"
},
"values": [{"external_id": "platform_value_d847f9a494487f5e95ad218f7beecac646f15989",
"value": {"de-DE": "Windows, Linux",
"en-US": "Windows, Linux"
}
}
]
}
],
"description": {"en": "Example game 1"
},
"groups": [{"external_id": "horror",
"name": {"en": "Horror"
}
}
],
"image_url": "https://image.example.com",
"is_enabled": true,
"is_free": false,
"is_show_in_store": false,
"item_id": 1,
"long_description": {"en": "Example game's long description"
},
"media_list": [{"type": "image",
"url": "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"
}
],
"name": {"en": "Game 1"
},
"order": 1,
"sku": "com.xsolla.game_1",
"type": "unit",
"unit_items": [{"drm_id": 1,
"drm_image": "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png",
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_sales_exist": false,
"is_show_in_store": false,
"item_id": 3,
"keys": {"available": 3,
"total": 4,
"used": 1
},
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": null,
"is_enabled": false,
"release_date": null
},
"prices": [{"amount": 1199.99,
"country_iso": "RU",
"currency": "RUB",
"is_default": true,
"is_enabled": true
}
],
"sku": "com.xsolla.game_1_key_1",
"type": "game_key",
"virtual_prices": [ ]
},
{"drm_id": 8,
"drm_image": null,
"drm_name": "Epic Games Store",
"drm_sku": "epicgames_key_1",
"is_enabled": true,
"is_free": false,
"is_sales_exist": false,
"is_show_in_store": false,
"item_id": 4,
"keys": {"available": 0,
"total": 0,
"used": 0
},
"limits": {"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"order": 1,
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": null,
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 1299.99,
"country_iso": "RU",
"currency": "RUB",
"is_default": true,
"is_enabled": true
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_1_key_2",
"type": "game_key",
"virtual_prices": null
}
]
}