Обновление цепочки предложений

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

Request Body schema: application/json

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 Вьетнамский

date_start

required

string <date-time>

Дата начала действия цепочки предложений.

required

Array of objects

Array

step_number

required

integer >= 1

Номер уровня.

is_free

required

boolean

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

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

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания.
quantity required	integer >= 1 Количество товаров в вознаграждении для этого уровня цепочки.
order	integer or null >= 0 Заказ на вознаграждение за уровень цепочки предложений.

step_id

integer or null >= 1

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

is_enabled

required

boolean

date_end

string or null <date-time>

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

(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 Вьетнамский

integer

Уникальный ID цепочки предложений.

order

integer

Определяет порядок расположения.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null))

Интервал сброса цепочки предложений.

One of:

Еженедельный сброс цепочки предложений.

interval_type required	string Частота сброса цепочки предложений. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Время сброса цепочки предложений в указанном часовом поясе (с округлением до часов). Например, время сброса установлено на 01:00 по часовому поясу Куала-Лумпура (GMT+8), значение параметра `time` будет `01:00:00+08:00`.
day_of_week required	integer [ 1 .. 7 ] День недели, когда происходит сброс, где `1` — понедельник, `7` — воскресенье.

Responses

204

Цепочка предложений успешно обновлена.

401

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

404

Цепочка предложений не найдена.

422

Некорректная конфигурация цепочки предложений.

Request samples

application/json

{"date_end": null,
"date_start": "2023-04-15T18:16:00+05:00",
"description": {"en": "Updated offer chain description"
},
"is_enabled": true,
"name": {"en": "Updated offer chain",
"ru": "Обновленная цепочка товаров"
},
"order": 4,
"steps": [{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_2"
}
],
"step_number": 2
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vg_not_shown_in_store"
}
],
"step_id": 10,
"step_number": 3
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_id": 8,
"step_number": 4
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 5
}
]
}

Response samples

application/json

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