Создание виртуального предмета

Создание виртуального предметаServer-sideAdmin

post/v2/project/{project_id}/admin/items/virtual_items

Создает виртуальный предмет.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

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

Example: 44056

Request Body schema: application/json

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

custom_attributes

object <json> <= 500 characters

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

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

groups

Array of strings

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

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

image_url

string

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

object

Определяет параметры предмета инвентаря.

consumable

boolean

Default: true

Является ли предмет расходуемым. Если true, то предмет расходуемый. Если false, то предмет нерасходуемый.

object or null

Определяет условия истечения срока действия, если это предмет с ограниченным сроком действия. Передайте null, если это предмет без ограничения срока действия.

type	string Определяет тип истечения срока действия предмета. Enum: "minute" "hour" "day" "week" "month" "year"
value	integer Определяет значение срока действия.

is_deleted

boolean

is_enabled

boolean

is_free

boolean

Default: false

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

is_show_in_store

boolean

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

Дополнительные ассеты предмета, такие как скриншоты, видео игрового процесса и так далее.

Array

type	string Тип медиа: `image`/`video`. Enum: "image" "video"
url	string Ссылка на файл.

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

order

integer

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

Array of objects or null

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

Array

date_from	string <date-time> Дата, когда указанный товар будет доступен для продажи.
date_until	string or null <date-time> Дата, когда указанный товар станет недоступен для продажи. Может быть `null`.

object

release_date required	string or null <date-time>
is_enabled required	boolean
description	string or null

Array of objects

Array

amount required	number > 0 Сумма.
currency required	string Валюта, в которой указана цена товара. Трехбуквенный код в соответствии с ISO 4217. Подробную информацию о валютах, поддерживаемых Xsolla, смотрите в документации.
country_iso	string Двухбуквенное обозначение страны в верхнем регистре согласно стандарту ISO 3166-1 alpha-2. Список стран, поддерживаемых Xsolla, приведен в документации. Example: `country=US`
is_default	boolean Default: false
is_enabled	boolean Default: true

Array of objects

Array

id	integer >= 1

sku

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

Array of objects

Array

amount required	integer
is_default required	boolean Default: false
is_enabled required	boolean Default: false Цена включена.
sku	string Уникальный ID товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.

Responses

201

Виртуальный предмет успешно создан.

422

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

Request samples

application/json

{"attributes": [{"external_id": "craft-materials",
"name": {"en": "Craft materials"
},
"values": [{"external_id": "steel",
"value": {"en-US": "5"
}
},
{"external_id": "leather",
"value": {"en-US": "1"
}
}
]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"de": "Ein Schwert ist eine Nahkampfwaffe mit Klinge, die zum Schneiden oder Stechen bestimmt ist, länger als ein Messer oder Dolch ist und aus einer langen Klinge besteht, die an einem Griff befestigt ist.",
"en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt."
},
"groups": ["weapons"
],
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": 100,
"per_user": 5
},
"name": {"de": "Schwert",
"en": "Sword"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 100,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 200,
"country_iso": "CZ",
"currency": "CZK",
"is_default": true,
"is_enabled": false
}
],
"sku": "sword",
"vc_prices": [ ]
}

Response samples

application/json

{"sku": "new-sku"
}