Lire un jeu pour administration

Xsolla Developers

Lire un jeu pour administrationServer-sideAdmin

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

Récupère des informations sur un jeu au sein d'un projet à des fins d'administration. Le jeu consiste en des clés de jeu qui peuvent être achetées par un utilisateur.

Note

N'utilisez pas cet endpoint pour créer un catalogue de magasin.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet. Example: 44056
item_sku required	string UGS de l'objet. Example: booster_mega_1

query Parameters

promo_code

string [ 1 .. 128 ] characters

Code unique sensible à la casse. Comprend des lettres et des chiffres.

Example: promo_code=WINTER2021

Responses

200

Le jeu a été reçu avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

404

Jeu non trouvé.

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
}
]
}