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

Admin
Копировать для LLM
Копировать страницу как Markdown для LLM
Просмотреть как Markdown
Открыть эту страницу как Markdown
Открыть в ChatGPT
Получить анализ от ChatGPT
Открыть в Claude
Получить инсайты от Claude

Операции

Получение списка виртуальных предметов по указанному ID группыServer-sideAdmin

Запрос

Получает список виртуальных предметов в рамках группы для администрирования.

Примечание

Не используйте данный метод для построения каталога магазина.

Безопасность

basicAuth

Путь

project_idintegerобязательный

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

Пример: 44056

group_idintegerобязательный

ID группы.

Пример: 10

Запрос

limitinteger>= 1

Лимит количества элементов на странице.

Пример: limit=50

offsetinteger>= 0

Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

Пример: offset=0

curl -i -X GET \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ru/api/catalog/v2/project/44056/admin/items/virtual_items/group/id/10?limit=50&offset=0'

Ответы

Список виртуальных предметов успешно получен.

Телоapplication/json

itemsArray of objects(Virtual-Items-Currency_admin-virtual-item)

Ответ

application/json

{
  "items": [
    { … },
    { … },
    { … },
    { … }
  ]
}

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

Запрос

Удаляет виртуальный предмет.

Безопасность

basicAuth

Путь

project_idintegerобязательный

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

Пример: 44056

item_skustringобязательный

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

Пример: booster_mega_1

curl -i -X DELETE \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ru/api/catalog/v2/project/44056/admin/items/virtual_items/sku/booster_mega_1

Ответы

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

Тело

Ответ

Нет содержимого

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

Запрос

Получает виртуальный предмет в рамках проекта для администрирования.

Примечание

Не используйте данный метод для построения каталога магазина.

Безопасность

basicAuth

Путь

project_idintegerобязательный

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

Пример: 44056

item_skustringобязательный

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

Пример: booster_mega_1

curl -i -X GET \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ru/api/catalog/v2/project/44056/admin/items/virtual_items/sku/booster_mega_1

Ответы

Указанный виртуальный предмет успешно получен.

Телоapplication/json

attributesArray of objects(Virtual-Items-Currency_admin-attributes)

Список атрибутов.

Пример: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]}]

custom_attributesobject(json)(item-custom-attributes-response)

JSON-объект, содержащий атрибуты товара и их значения.

description(two-letter (object or null)) or (five-letter (object or null))(description-localization-object)

Объект с локализованными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

One of:

Объект с локализованными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

groupsArray of objects(Virtual-Items-Currency_admin-groups-response)

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

По умолчанию []

Пример: [{"external_id":"horror","name":{"en":"Horror"}}]

image_urlstring(Virtual-Items-Currency_admin-image_url)

is_enabledboolean(Virtual-Items-Currency_is_enabled)

is_freeboolean(value-is_free)

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

По умолчанию false

Пример: false

is_show_in_storeboolean(Virtual-Items-Currency_is_show_in_store)

limitsobject or null(admin-item-limit-response)

Ограничения на продажу товара.

long_description(two-letter (object or null)) or (five-letter (object or null))(long-description-localization-object)

Объект с локализованными длинными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

Any of:

Объект с локализованными длинными описаниями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код локали из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется код из двух символов. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

media_listArray of objects(Virtual-Items-Currency_admin-media_list)

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

Пример: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

name(two-letter (object or null)) or (five-letter (object or null))(name-localization-object)

Объект с локализованными названиями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код языка из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется двухбуквенный код языка. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

One of:

Объект с локализованными названиями товара. Принимает значения в одном из двух форматов: двухбуквенный код языка в нижнем регистре (например, en) или код языка из пяти символов (например, en-US). Оба формата допустимы при отправке запроса, но в ответе всегда используется двухбуквенный код языка. Если для одного языка указаны оба варианта (например, en и en-US), будет сохранено последнее переданное значение. Полный список поддерживаемых языков приведен в документации.

orderinteger(Virtual-Items-Currency_order)

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

Пример: 1

periodsArray of objects(item-periods-response)

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

pricesArray of objects(Virtual-Items_admin-prices)

Пример: [{"amount":10.5,"currency":"USD","is_default":true,"is_enabled":true}]

regionsArray of objects(Virtual-Items-Currency_admin-regions)

skustring(Virtual-Items-Currency_sku)[ 1 .. 255 ] characters^[a-zA-Z0-9_\-–.]*$

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

Пример: "booster_mega_1"

typestring(Virtual-Items-Currency_type)

Тип товара: virtual_good/virtual_currency/bundle/physical_good/unit.

vc_pricesArray of objects(Virtual-Items-Currency_admin-get-vc_prices)

Пример: [{"amount":10,"is_default":true,"sku":"com.xsolla.gold_1"}]

Ответ

application/json

{
  "attributes": [
    { … }
  ],
  "custom_attributes": {
    "attr": "value",
    "purchased": 0
  },
  "description": {
    "en": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel"
  },
  "groups": [
    { … },
    { … }
  ],
  "image_url": "https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png",
  "is_enabled": true,
  "is_free": false,
  "is_show_in_store": true,
  "limits": {
    "per_item": null,
    "per_user": { … },
    "recurrent_schedule": { … }
  },
  "long_description": {
    "en": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel"
  },
  "media_list": [],
  "name": {
    "en": "Sword Xsolla Skin"
  },
  "order": 1,
  "periods": [
    { … }
  ],
  "prices": [
    { … }
  ],
  "regions": [],
  "sku": "com.xsolla.swords_1",
  "type": "virtual_good",
  "vc_prices": []
}