Обновление бандла

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

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

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 <= 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... Время обновления ограничений в желаемом часовом поясе (округление до часов).

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 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": {"attributes": [{"external_id": "class",
"name": {"en-US": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en-US": "Soldier"
}
},
{"external_id": "officer",
"value": {"en-US": "Officer"
}
}
]
}
]
},
"content": [{"quantity": 1,
"sku": "iron_gloves"
},
{"quantity": 1,
"sku": "iron_boots"
},
{"quantity": 1,
"sku": "iron_shield"
},
{"quantity": 1,
"sku": "iron_armour"
},
{"quantity": 1,
"sku": "iron_helmet"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de-DE": "Brustpanzer für Soldaten",
"en-US": "Chest of armour for soldiers"
},
"groups": ["chests"
],
"image_url": "https://picture.bundle-with-many-stuff.png",
"is_enabled": true,
"is_free": true,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"de-DE": "Brustpanzer für Soldaten",
"en-US": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de-DE": "Brustpanzer",
"en-US": "Chest of armour"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 9.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 9.99,
"currency": "EUR",
"is_default": false,
"is_enabled": true
}
],
"sku": "armour_chest",
"vc_prices": null
}

Response samples

application/json

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