Xsolla-logo

Предоставление права владения (администратор)Server-sideAdmin

post/v2/project/{project_id}/admin/entitlement/grant

Дает пользователю право владения.

Внимание

Могут быть предоставлены только игровые ключи или игры для DRM-free-платформ.
SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

Example: 44056
Request Body schema: application/json
user_external_id
required
string

Уникальный идентификатор пользователя.

required
object

Объект со свойствами игры.

sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

Уникальный ID пакета ключей.

required
object

Объект со свойствами DRM.

sku
required
string

Уникальный ID платформы.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus" "rockstar" "viveport" "stadia"
mode
required
string

Какой тип прав владения должен быть предоставлен. Если параметру присвоено значение sandbox, пользователю будет предоставлено право владения в режиме тестового окружения. Если для параметра установлено значение default, пользователю будет предоставлено право владения в режиме боевого окружения.

Enum: "default" "sandbox"
code
string or null

Игровой ключ.

user_country
string or null

Страна пользователя.

Responses
200

Право владения предоставлено.

403

Заголовок Authorization не отправлен.

404

Игровой ключ не найден. Убедитесь, что верно указали code и project_id.

422

Неверный запрос.

Request samples
application/json
{
  • "code": "AAAA-BBBB-CCCC-DDDD",
  • "drm": {
    },
  • "game": {
    },
  • "mode": "default",
  • "user_country": "US",
  • "user_external_id": "user-external-id"
}
Response samples
application/json
{
  • "errorCode": 0,
  • "errorMessage": "Authorization header not sent",
  • "statusCode": 403
}