Xsolla-logo

Обновление акции со скидкамиServer-sideAdmin

put/v2/project/{project_id}/admin/promotion/{promotion_id}/item

Обновляет акцию.

Примечание

Новые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные.

Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
promotion_id
required
integer

ID акции. Уникальный идентификатор акции в рамках проекта.

Example: 111425
Request Body schema: application/json

Объект с данными акции.

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

Артикул товара.

required
object
percent
required
string

Процент скидки. Цена товара будет уменьшена с использованием значения, рассчитанного с использованием этого процента, а затем округлена до 2 знаков после запятой.

required
object

Название акции. Данный параметр должен содержать пары ключ/значение, где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение — строка.

property name*
additional property
string
Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)
One of:
[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Код атрибута пользователя.

operator
required
string

Тип операции, выполняемой по условию. Для типа атрибута string.

Enum: Description
eq

Равно

ne

Не равно

value
required
string <= 255 characters

Значение условия, с которым будет сравниваться значение атрибута пользователя. Тип зависит от типа атрибута.

type
required
string

Тип атрибута пользователя.

Value: "string"
can_be_missing
boolean

Считается ли условие выполненным, если этот атрибут отсутствует в атрибутах пользователя. Передайте true, чтобы показывать товар пользователям, у которых нет этого атрибута. Пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, не увидят товар. false — пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, или атрибута нет, не увидят товар.

date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Дата, когда ваша акция будет завершена. Может быть null.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Дата, когда начнется ваша акция.

excluded_promotions
Array of integers

Список акций, которые исключаются при применении этой акции.
Example: [12, 789]

object

Ограничения акции.

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

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

Array of objects or null

Array of objects with conditions that set the price range for applying the promotion.
The promotion applies only to items whose price meets all the conditions in the array. If you pass this array, set the value of the items object to null.

Array
operator
required
string

Comparison operator for setting the price range for applying the promotion.

Enum: Description
eq

Равно

ge

Greater or equal

gt

Greater than

le

Less or equal

lt

Less than

ne

Не равно

value
required
string^\\d+(\\.\\d{1,4})?$

Value for determining the price range for applying the promotion.

Responses
204

Акция успешно обновлена.

401

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

404

Акция не найдена. Убедитесь, что верно указали promotion_id.

422

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

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": null,
  • "name": {
    }
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}