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

Создание ежедневной наградыServer-sideAdmin

post/v2/project/{project_id}/admin/daily_chain

Создает ежедневную награду.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
Request Body schema: application/json
One of:

Base properties for calendar_hard daily reward type.

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

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

required
Array of objects non-empty
Array (non-empty)
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

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

quantity
required
integer >= 1

Количество уровней ежедневной награды для этого артикула

is_enabled
required
boolean
type
required
string

Daily reward type that determines when users can claim rewards.

Enum: Description
calendar_hard

Unlocks the next step reward every 24 hours. Any unclaimed step rewards are permanently lost once the next step reward becomes available.

rolling_skippable

Unlocks the next step reward every 24 hours based on date_start. Progression is sequential: a new reward will not unlock until the previous one has been claimed. If a user skips one or more days, they continue from where they left off; missed days do not grant multiple rewards.

rolling_unskippable

Unlocks the next step reward every 24 hours based on date_start. Progression is sequential: a new reward will not unlock until the previous one has been claimed. However, if a user skips a day, their progress is reset, and they must start again from the first step.

is_recurrent
boolean
Default: false

Whether the daily reward is recurrent. If true, the daily reward will automatically reset after the end date. The next start_date and end_date schedule is based on the number of daily reward steps and the initial time set on start_date.

(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

Вьетнамский

order
integer

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

Responses
201

Ежедневная награда была успешно создана.

401

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

422

Ошибки в настройках ежедневных наград.

Request samples
application/json
{
  • "date_start": "2023-04-15T18:16:00+05:00",
  • "description": {
    },
  • "is_enabled": true,
  • "name": {
    },
  • "order": 4,
  • "steps": [
    ],
  • "type": "calendar_hard"
}
Response samples
application/json
{
  • "daily_chain_id": 10
}