Xsolla-logoXsolla Developers
или
Личный кабинет

Обновление бандлаServer-sideAdmin

put/v2/project/{project_id}/admin/items/bundle/sku/{sku}

Обновляет бандл.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
sku
required
string

Артикул бандла.

Example: kg_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
(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 <= 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
Array of objects non-empty
Array (non-empty)
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

quantity
integer >= 1
Default: 1

Количество выбранных товаров в бандле.

custom_attributes
object <json> <= 500 characters

JSON-объект, содержащий атрибуты товара и их значения. Атрибуты позволяют добавить дополнительную информацию к товарам. Например, указать уровень игрока, на котором ему станет доступен этот товар. Атрибуты дополняют внутреннюю логику игры и могут быть получены через GET-методы и вебхуки.

groups
Array of strings
Default: []

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

Примечание. Строковое значение относится к группе `external_id`.
image_url
string or null

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

is_enabled
boolean
Default: true

Если этот параметр отключен, товар не может быть найден и приобретен.

is_free
boolean
Default: false

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

is_show_in_store
boolean
Default: false

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

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))

Объект с локализованными длинными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, 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 or null

Дополнительные ассеты бандла.

Array
type
string

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

Enum: "image" "video"
url
string

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

order
integer
Default: 1

Приоритет заказа бандла в списке.

Array of objects or null

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

Array
date_from
string <date-time>

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

date_until
string or null <date-time>

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

Array of objects

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

Array
amount
required
string^\d*\.?\d*$

Цена товара.

currency
required
string

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

is_default
required
boolean

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

is_enabled
required
boolean

Цена включена.

country_iso
string or null

Страна, где доступна эта цена. Двухбуквенный код в соответствии с ISO 3166-1 alpha 2.

Array of objects
Array
id
integer >= 1
Array of objects or null
Array
amount
required
integer
is_default
required
boolean
is_enabled
required
boolean
sku
string

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

Responses
204

Бандл успешно обновлен.

401

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

422

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

Request samples
application/json
{
  • "attributes": [
    ],
  • "content": [
    ],
  • "custom_attributes": {
    },
  • "description": {
    },
  • "groups": [
    ],
  • "image_url": "https://picture.bundle-with-many-stuff.png",
  • "is_enabled": true,
  • "is_free": true,
  • "limits": {
    },
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "order": 1,
  • "periods": [
    ],
  • "prices": [
    ],
  • "sku": "com.xsolla.armour_chest_1",
  • "vc_prices": [ ]
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.