Xsolla-logo

Создание игры

post/v2/project/{project_id}/admin/items/game

Создает игру в проекте.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
Request Body schema: application/json

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

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

Уникальный ID товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.

required
object

Объект с локализациями для названия товара. Двухбуквенный код языка в нижнем регистре.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
required
Array of objects

Платформы публикации игры.

Array
sku
required
string [ 1 .. 255 ] characters

Уникальный ID товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.

drm_sku
required
string

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

required
Array of objects

Цены в реальных валютах.

Array
amount
required
number
currency
required
string

Валюта покупки по умолчанию. Трехбуквенный код в соответствии с ISO 4217.

is_default
required
boolean

Цена по умолчанию используется для построения каталога, если цена в валюте пользователя не указана.

is_enabled
required
boolean
Array of objects

Список атрибутов.

Array
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

Уникальный ID атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

required
Array of objects
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

Объект с локализациями для названия значения. Ключи для обозначения стран указаны в стандарте ISO 3166-1.

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

object
Default: {"de":"Genre","en":"Genre"}

Объект с локализациями для названия атрибута. Ключи для обозначения стран указаны в стандарте ISO 3166-1.

property name*
additional property
string
Array of objects

Группы, к которым принадлежит товар.

Array
external_id
required
string
is_enabled
boolean

Если этот параметр отключен, товар нельзя приобрести и получить к нему доступ через инвентарь.

is_free
boolean
Default: false

Если true, товар бесплатный.

is_show_in_store
boolean

Товар доступен для покупки.

object

Ограничения на продажу товара.

per_item
integer or null

Глобальное ограничение товара.

per_user
integer or null

Ограничение количества товара для отдельного пользователя.

object or null

Период обновления установленный ограничений.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)
One of:

Ежедневное обновления пользовательских ограничений.

interval_type
required
string

Период обновления ограничений.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Время обновления ограничений в желаемом часовом поясе (округление до часов).

object

Объект с локализациями для названия товара. Двухбуквенный код языка в нижнем регистре.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
order
integer

Приоритет порядка игры в списке.

Array of objects or null

Период продажи товара.

Array
date_from
string <date-time>

Дата, когда указанный товар будет доступен для продажи.

date_until
string or null <date-time>

Дата, когда указанный товар станет недоступен для продажи. Может быть null.

object

Настройки предзаказа.

release_date
required
string

Дата выпуска игры на платформе в формате ISO 8601.

is_enabled
required
boolean

Если этот параметр отключен, товар не является предзаказом.

description
string

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

Array of objects
Array
id
integer
Array of objects
Array
amount
required
number
is_default
required
boolean
is_enabled
required
boolean
sku
string

Уникальный ID товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.

Array of objects <= 20 items

Список атрибутов.

Внимание. Для товара невозможно указать более 20 атрибутов. Любые попытки превысить данное ограничение вызовут ошибку.
Array (<= 20 items)
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

Уникальный ID атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

required
Array of objects
Внимание. Невозможно создать более 6 значений для каждого атрибута . Любые попытки превысить данное ограничение вызовут ошибку.
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

Объект с локализациями для названия значения. Ключи для обозначения стран указаны в стандарте ISO 3166-1.

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

object
Default: {"de":"Genre","en":"Genre"}

Объект с локализациями для названия атрибута. Ключи для обозначения стран указаны в стандарте ISO 3166-1.

property name*
additional property
string
object

Объект с локализациями для описания товара. Двухбуквенный код языка в нижнем регистре.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
Array of objects

Группы, к которым принадлежит товар.

Array
external_id
required
string
image_url
string

URL изображения.

is_enabled
boolean

Если этот параметр отключен, товар нельзя приобрести и получить к нему доступ через инвентарь.

is_show_in_store
boolean

Товар доступен для покупки.

object

Объект с локализациями для длинного описания товара. Двухбуквенный код языка в нижнем регистре.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
Array of objects

Дополнительные ассеты игры, такие как скриншоты, видео игрового процесса и т.д.

Array
type
string

Тип медиа: image/video.

Enum: "image" "video"
url
string

Ссылка на файл.

order
integer

Приоритет порядка игры в списке.

Responses
201

Игра успешно создана.

401

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

422

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

Request samples
application/json
{
  • "description": {
    },
  • "groups": [
    ],
  • "image_url": "http://image.png",
  • "is_enabled": true,
  • "is_show_in_store": true,
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "sku": "game_1",
  • "unit_items": [
    ]
}
Response samples
application/json
{
  • "item_id": 101,
  • "sku": "game_1"
}