Обновление игры по артикулу

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

Request Body schema: application/json

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

sku

required

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

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

required

(two-letter (object or null)) or (five-letter (object or null))

Объект с локализованными названиями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код языка из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется двухбуквенный код языка. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

One of:

Двухбуквенные строчные языковые коды.

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 Spanish (Spain)
fr	string or null Французский
he	string or null Иврит
id	string or null Индонезийский
it	string or null Итальянский
ja	string or null Японский
km	string or null Кхмерский
ko	string or null Корейский
lo	string or null Лаосский
my	string or null Бирманский
ne	string or null Непальский
ph	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

drm_sku

required

string

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

required

Array of objects

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

Array

amount required	number
currency required	string Валюта, в которой указана цена товара. Трехбуквенный код в соответствии с ISO 4217. Подробную информацию о валютах, поддерживаемых Xsolla, смотрите в документации.
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... Время обновления ограничений в желаемом часовом поясе (округление до часов).

(two-letter (object or null)) or (five-letter (object or null))

One of:

Двухбуквенные строчные языковые коды.

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 Spanish (Spain)
fr	string or null Французский
he	string or null Иврит
id	string or null Индонезийский
it	string or null Итальянский
ja	string or null Японский
km	string or null Кхмерский
ko	string or null Корейский
lo	string or null Лаосский
my	string or null Бирманский
ne	string or null Непальский
ph	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

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-_]+$

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]+$

object

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

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

property name*

additional property

string

(two-letter (object or null)) or (five-letter (object or null))

Объект с локализованными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

One of:

Двухбуквенные строчные языковые коды.

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 Spanish (Spain)
fr	string or null Французский
he	string or null Иврит
id	string or null Индонезийский
it	string or null Итальянский
ja	string or null Японский
km	string or null Кхмерский
ko	string or null Корейский
lo	string or null Лаосский
my	string or null Бирманский
ne	string or null Непальский
ph	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

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

(two-letter (object or null)) or (five-letter (object or null))

Объект с локализованными длинными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

Any of:

Двухбуквенные строчные языковые коды.

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 Spanish (Spain)
fr	string or null Французский
he	string or null Иврит
id	string or null Индонезийский
it	string or null Итальянский
ja	string or null Японский
km	string or null Кхмерский
ko	string or null Корейский
lo	string or null Лаосский
my	string or null Бирманский
ne	string or null Непальский
ph	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

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

404

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

422

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

Request samples

application/json

{"description": {"en-US": "Game description",
"ru-RU": "Краткое описание игры"
},
"groups": ["new_games"
],
"image_url": "http://image.png",
"is_enabled": true,
"is_show_in_store": true,
"long_description": {"en-US": "Game long description",
"ru-RU": "Полное описание игры"
},
"media_list": [{"type": "image",
"url": "http://image.png"
},
{"type": "video",
"url": "http://video.png"
}
],
"name": {"en-US": "Game name",
"ru-RU": "Название игры"
},
"sku": "com.xsolla.game_1",
"unit_items": [{"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 5
}
},
"name": {"en-US": "Game key name",
"ru-RU": "Название игрового ключа"
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": "Some description",
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 35.5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_key_1",
"vc_prices": [{"amount": 35.5,
"is_default": true,
"is_enabled": true,
"sku": "com.xsolla.gold_1"
}
]
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}