{ "openapi": "3.0.0", "info": { "description": "# Введение\n\nDigital Distribution Hub — новое решение Иксоллы, которое соединяет электронные и физические платежи через технологию push-платежей и e-commerce.\n\nДанная документация включает в себя описание методов API для продуктов [Внутриигровой магазин](https://developers.xsolla.com/ru/doc/in-game-store/) и [Платежи](https://developers.xsolla.com/ru/doc/pay-station/). Используется два базовых URL-адреса:\n\n* `https://store.xsolla.com/api` для групп **Общие**, **Каталог**, **Корзина** и **Заказ**.\n* `https://ps.xsolla.com` для группы **Уведомления**.\n\nИспользование методов API из группы **Каталог** не требует авторизации. \n\nЧтобы использовать методы API из групп **Корзина** и **Заказ**, вам необходимо [создать токен](https://developers.xsolla.com/ru/digital-distribution-hub/common/user-token/create-user-token).\n\n
Примечание

Данная документация не является полностью функциональным интерфейсом и представляет собой дизайн будущего API. В настоящее время вы можете использовать только методы из групп Каталог и Уведомления. Если вы хотите поделиться обратной связью, отправьте нам письмо по адресу techdoc@xsolla.com.
", "title": "Digital Distribution Hub", "version": "1.0.0" }, "servers": [ { "url": "https://store.xsolla.com/api" } ], "tags": [ { "name": "cart", "x-displayName": "Корзина" }, { "name": "game keys", "x-displayName": "Игровые ключи" }, { "name": "virtual items & currency", "x-displayName": "Виртуальные предметы и валюта" }, { "name": "bundles", "x-displayName": "Бандлы" }, { "name": "user token", "x-displayName": "Токен пользователя" }, { "name": "notifications", "x-displayName": "Уведомления" }, { "name": "order", "x-displayName": "Заказ" } ], "paths": { "/push-payments/cancel": { "post": { "description": "Отправьте уведомление об отмене платежа в следующих случаях:\n - платеж не был выполнен;\n - был оформлен возврат платежа.", "operationId": "cancel-notification", "requestBody": { "content": { "application/json": { "example": { "payment_id": 784998479 }, "schema": { "properties": { "payment_id": { "type": "integer" } }, "required": [ "payment_id" ], "type": "object" } } } }, "responses": { "200": { "description": "OK." }, "400": { "description": "Bad request." }, "403": { "description": "Доступ запрещен." }, "404": { "description": "Платеж не найден." }, "409": { "description": "Платеж уже отменен." }, "422": { "description": "Ошибка при отмене платежа." }, "500": { "description": "Внутренняя ошибка сервера." } }, "servers": [ { "url": "https://ps.xsolla.com" } ], "summary": "Уведомление об отмене", "tags": [ "notifications" ] } }, "/push-payments/pay": { "post": { "description": "Отправьте это уведомление после успешного списания средств пользователя.", "operationId": "pay-notification", "requestBody": { "content": { "application/json": { "example": { "payment": { "amount": 10, "currency": "USD", "geotype_id": 13038, "ps_transaction_id": "ps_transaction_id" }, "project_id": 18404, "purchase": { "order_id": 1334430 }, "user": { "id": "s.ivanov" } }, "schema": { "properties": { "payment": { "properties": { "amount": { "description": "Сумма платежа.", "type": "number" }, "currency": { "description": "Валюта платежа. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "type": "string" }, "geotype_id": { "description": "Идентификатор партнера-дистрибьютора на стороне Иксоллы.", "type": "integer" }, "project_transaction_id": { "description": "Идентификатор транзакции на стороне разработчика игры.", "type": "string" }, "ps_transaction_id": { "description": "Идентификатор транзакции на стороне партнера-дистрибьютора.", "type": "string" } }, "required": [ "geotype_id", "amount" ], "type": "object" }, "project_id": { "description": "ID проекта.", "type": "integer" }, "purchase": { "properties": { "order_id": { "description": "Идентификатор заказа.", "type": "integer" } }, "required": [ "order_id" ], "type": "object" }, "user": { "properties": { "email": { "description": "Email-адрес пользователя.", "type": "string" }, "id": { "description": "Уникальный идентификатор пользователя в игре.", "type": "string" }, "phone": { "description": "Номер телефона пользователя.", "type": "string" }, "ps_account_id": { "description": "Идентификатор платежного аккаунта пользователя на стороне партнера-дистрибьютора.", "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "project_id", "payment", "purchase", "user" ], "type": "object" } } } }, "responses": { "200": { "content": { "application/json": { "example": { "payment_id": 784998484 }, "schema": { "properties": { "payment_id": { "type": "integer" } }, "type": "object" } } }, "description": "OK." }, "400": { "description": "Bad request." }, "403": { "description": "Доступ запрещен." }, "404": { "description": "Заказ не найден." }, "409": { "description": "Заказ уже оплачен." }, "422": { "description": "Ошибка при создании платежа." }, "500": { "description": "Внутренняя ошибка сервера." } }, "servers": [ { "url": "https://ps.xsolla.com" } ], "summary": "Уведомление об оплате", "tags": [ "notifications" ] } }, "/v2/project/{project_id}/cart": { "get": { "description": "Возвращает корзину текущего пользователя.", "operationId": "get-user-cart", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/currency-query-param" }, { "$ref": "#/components/parameters/locale-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "cart_id": "cart_id", "is_free": false, "items": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" } } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200" } } }, "description": "Корзина с предметами успешно возвращена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение корзины текущего пользователя", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/clear": { "put": { "description": "Удаляет все предметы из корзины.", "operationId": "cart-clear", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "204": { "description": "Корзина успешно очищена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Удаление всех предметов из текущей корзины", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/fill": { "put": { "description": "Наполняет корзину предметами. Если в корзине уже есть предмет с таким же артикулом, существующий предмет будет заменен.", "operationId": "cart-fill", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/fill-cart-json-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "cart_id": "cart_id", "is_free": false, "items": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "warnings": [ { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found", "quantity": 1, "sku": "booster_mega_21" } ] } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200_1" } } }, "description": "Корзина с предметами успешно возвращена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Наполнение корзины предметами", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/item/{item_sku}": { "delete": { "description": "Удаляет предмет из корзины.", "operationId": "delete-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "responses": { "204": { "description": "Предмет из корзины успешно удален." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны верно." } }, "security": [ { "AuthForClient": [] } ], "summary": "Удаление предмета из текущей корзины", "tags": [ "cart" ] }, "put": { "description": "Обновляет существующий или создает новый предмет в корзине.", "operationId": "put-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/put-item-by-cart-id-json-model" }, "responses": { "204": { "description": "Корзина успешно обновлена." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны верно." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1421, "errorMessage": "Only Virtual Good Supported", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_422_1" } } }, "description": "Этот тип предмета нельзя добавить в корзину. Выберите другой тип." } }, "security": [ { "basicAuth": [] } ], "summary": "Обновление предмета из текущей корзины", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}": { "get": { "description": "Возвращает корзину пользователя по идентификатору корзины.", "operationId": "get-cart-by-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" }, { "$ref": "#/components/parameters/currency-query-param" }, { "$ref": "#/components/parameters/locale-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "cart_id": "cart_id", "is_free": false, "items": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" } } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200" } } }, "description": "Корзина с предметами успешно возвращена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение корзины по идентификатору корзины", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/clear": { "put": { "description": "Удаляет все предметы из корзины.", "operationId": "cart-clear-by-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "responses": { "204": { "description": "Корзина успешно очищена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Удаление всех предметов из корзины по ID корзины", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/fill": { "put": { "description": "Наполняет определенную корзину предметами. Если в корзине уже есть предмет с таким же артикулом, существующий предмет будет заменен.", "operationId": "cart-fill-by-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/fill-cart-json-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "cart_id": "cart_id", "is_free": false, "items": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "price": { "amount": "6150.0000000000000000", "amount_without_discount": "6150.0000000000000000", "currency": "USD" }, "warnings": [ { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found", "quantity": 1, "sku": "booster_mega_21" } ] } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_200_1" } } }, "description": "Корзина с предметами успешно возвращена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Наполнение определенной корзины предметами", "tags": [ "cart" ] } }, "/v2/project/{project_id}/cart/{cart_id}/item/{item_sku}": { "delete": { "description": "Удаляет предмет из корзины.", "operationId": "delete-item-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "responses": { "204": { "description": "Предмет из корзины успешно удален." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны верно." } }, "security": [ { "AuthForClient": [] } ], "summary": "Удаление предмета из корзины по ID корзины", "tags": [ "cart" ] }, "put": { "description": "Обновляет существующий или создает новый предмет в корзине.", "operationId": "put-item-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/put-item-by-cart-id-json-model" }, "responses": { "204": { "description": "Корзина успешно обновлена." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cart_inline_response_404" } } }, "description": "Предмет не найден. Убедитесь, что `project_id` и `item_sku` указаны верно." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1102, "errorMessage": "[0401-1102]: Item quantity must be non-negative integer", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Cart_inline_response_422" } } }, "description": "Количество предметов не должно быть отрицательным числом." } }, "security": [ { "basicAuth": [] } ], "summary": "Обновление предмета в корзине по ID корзины", "tags": [ "cart" ] } }, "/v2/project/{project_id}/distribution_hub/order/{order_id}": { "get": { "description": "Получение указанного заказа.", "operationId": "get-order", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/order-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "content": { "is_free": "false", "items": [ { "is_free": false, "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" }, "quantity": 1, "sku": "some_sku" } ], "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" } }, "order_id": 1, "status": "paid" } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200_1" } } }, "description": "Успешный запрос данных о заказе." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 9001, "errorMessage": "[0401-9001]: Order not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_404" } } }, "description": "Заказ не найден. Убедитесь, что `project_id` и `order_id` указаны верно." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение заказа", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/cart": { "post": { "description": "Создание заказа со всеми предметами из корзины. Созданному заказу присваивается статус `new`.", "operationId": "create-order", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "Заказ успешно создан." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1401, "errorMessage": "[0401-1401]: Invalid cart", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422" } } }, "description": "Недействительная корзина. Убедитесь, что корзина существует, она не пустая, и в ней отсутствуют бесплатные предметы." } }, "security": [ { "AuthForClient": [] } ], "summary": "Создание заказа со всеми предметами из текущей корзины", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/cart/{cart_id}": { "post": { "description": "Создание заказа со всеми предметами из указанной корзины. Созданному заказу присваивается статус `new`.", "operationId": "create-order-by-cart-id", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/cart-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "Заказ успешно создан." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1401, "errorMessage": "[0401-1401]: Invalid cart", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422" } } }, "description": "Недействительная корзина. Убедитесь, что корзина существует, она не пустая, и в ней отсутствуют бесплатные предметы." } }, "security": [ { "AuthForClient": [] } ], "summary": "Создание заказа со всеми предметами из определенной корзины", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/payment/item/{item_sku}": { "post": { "description": "Создание заказа с указанным предметом. Созданному заказу присваивается статус `new`.", "operationId": "create-order-with-item", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/create-order-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "billing_info": { "direct_taxes": [ { "amount": 150, "name": "TAX", "rate": 10 } ], "indirect_taxes": [ { "amount": 246.75, "name": "VAT", "rate": 20 } ], "price": { "amount": 1480.45, "currency": "USD" } }, "order_id": 641 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_200" } } }, "description": "Заказ успешно создан." }, "422": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 1411, "errorMessage": "[0401-1411]: Invalid item", "statusCode": 422 } } }, "schema": { "$ref": "#/components/schemas/Order_inline_response_422_1" } } }, "description": "Недействительный предмет. Убедитесь, что предмет существует, он не выключен, не удален и не является бесплатным." } }, "security": [ { "AuthForClient": [] } ], "summary": "Создание заказа с указанным предметом", "tags": [ "order" ] } }, "/v2/project/{project_id}/distribution_hub/user/auth": { "post": { "description": "Проверяет существование пользователя в игре и создает токен с его данными.", "operationId": "create-user-token", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "requestBody": { "$ref": "#/components/requestBodies/post-user-token-json-model" }, "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" } } }, "schema": { "$ref": "#/components/schemas/Common_inline_response_200_1" } } }, "description": "Токен пользователя успешно получен." } }, "security": [ { "basicAuth": [] } ], "summary": "Создание токена пользователя", "tags": [ "user token" ] } }, "/v2/project/{project_id}/items/bundle": { "get": { "description": "Получение списка бандлов для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе.
", "operationId": "get-bundle-list", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "$ref": "#/components/examples/200-get-bundle-list" } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_10" } } }, "description": "Список бандлов успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка бандлов", "tags": [ "bundles" ] } }, "/v2/project/{project_id}/items/bundle/sku/{sku}": { "get": { "description": "Получение указанного бандла.", "operationId": "get-bundle", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/sku-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "$ref": "#/components/examples/200-get-bundle" } }, "schema": { "$ref": "#/components/schemas/Catalog_client_bundle" } } }, "description": "Указанный бандл успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение указанного бандла", "tags": [ "bundles" ] } }, "/v2/project/{project_id}/items/game": { "get": { "description": "Получение списка игр для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-games-list", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200" } } }, "description": "Список игр успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка игр", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/drm": { "get": { "description": "Получение списка доступных DRM.", "operationId": "get-drm-list", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "drm": [ { "drm_id": 1, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "link": "https://support.steampowered.com", "name": "Steam", "redeem_instruction_link": "https://support.steampowered.com", "sku": "steam" }, { "drm_id": 2, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Playstation", "redeem_instruction_link": "https://support.us.playstation.com", "sku": "playstation" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_4" } } }, "description": "Список DRM успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка DRM", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/group/{external_id}": { "get": { "description": "Получение списка игр из указанной группы для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-games-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200" } } }, "description": "Список игр успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка игр для указанной группы", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/key/group/{external_id}": { "get": { "description": "Получение списка игр из указанной группы с привязкой к платформе для построения каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-game-keys-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": false, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_2", "type": "game_key", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_3" } } }, "description": "Список игр успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение игр с привязкой к платформе для указанной группы", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/key/sku/{item_sku}": { "get": { "description": "Получение игры на платформе для каталога.", "operationId": "get-game-key-by-sku", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_2" } } }, "description": "Игра успешно получена." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with sku = 'game_key_1' not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404_1" } } }, "description": "Игра не найдена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение игры на платформе для каталога", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/game/sku/{item_sku}": { "get": { "description": "Получение игры для каталога.", "operationId": "get-game-by-sku", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/item-sku-path-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_1" } } }, "description": "Игра успешно получена." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4001, "errorMessage": "[0401-4001]: Item with sku = 'game_1' not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404" } } }, "description": "Игра не найдена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение игры для каталога", "tags": [ "game keys" ] } }, "/v2/project/{project_id}/items/groups": { "get": { "description": "Получение списка групп предметов для создания каталога.", "operationId": "get-item-groups", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "groups": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 0, "name": "Accessory", "order": 1 }, { "children": [], "description": "Background", "external_id": "background", "level": 0, "name": "Background", "order": 1 }, { "children": [], "description": "Hair", "external_id": "hair", "level": 0, "name": "Hair", "order": 1 }, { "children": [], "description": "Outfit", "external_id": "outfit", "level": 0, "name": "Outfit", "order": 1 }, { "children": [], "description": "Body", "external_id": "body", "level": 0, "name": "Body", "order": 1 }, { "children": [], "description": "Body", "external_id": "delete_group", "level": 0, "name": "Body", "order": 1 }, { "children": [ { "children": [], "description": "Group description", "external_id": "test_group_secure", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 1, "name": "Test group secure", "order": 5, "parent_external_id": "very_cool_group" } ], "description": "Very cool group", "external_id": "very_cool_group", "level": 0, "name": "Very cool group", "order": 1 }, { "children": [ { "children": [], "description": "Group description", "external_id": "test_group_split", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 1, "name": "Test group secure", "order": 1, "parent_external_id": "test_group_secure" } ], "description": "Group description", "external_id": "test_group_secure", "image_url": "http://static.xsolla.com/img/xsolla-logo2.png", "level": 0, "name": "Test group secure", "order": 1 } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_9" } } }, "description": "Список групп успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка групп предметов", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_currency": { "get": { "description": "Получение списка виртуальных валют для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-virtual-currency", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - short description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_currency", "virtual_prices": [] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_currency", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_6" } } }, "description": "Список виртуальных валют успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка виртуальных валют", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_currency/package": { "get": { "description": "Получение списка пакетов виртуальной валюты для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-virtual-currency-package", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name first package", "price": { "amount": "2.0000", "amount_without_discount": "2.0000", "currency": "USD" }, "sku": "vc_package_1", "type": "bundle", "virtual_prices": [] }, { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "description", "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "SHOTGUN FOR TRUE RAIDERS", "quantity": 200, "sku": "shotgun_raider", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name third package", "price": { "amount": "4.0000", "amount_without_discount": "4.0000", "currency": "USD" }, "sku": "vc_package_3", "type": "bundle", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_7" } } }, "description": "Список пакетов виртуальной валюты успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка пакетов виртуальной валюты", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_items": { "get": { "description": "Получение списка виртуальных предметов для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-virtual-items", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": [ { "consumable": [ { "usages_count": 1 } ] }, { "expiration_period": [ { "type": "day" }, { "value": 1 } ] } ], "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_5" } } }, "description": "Список виртуальных предметов успешно получен." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка виртуальных предметов", "tags": [ "virtual items & currency" ] } }, "/v2/project/{project_id}/items/virtual_items/group/{external_id}": { "get": { "description": "Получение списка предметов из указанной группы для создания каталога. \n\n
Обратите внимание. Все проекты имеют ограничение на количество предметов, которые вы можете получить в ответе. По умолчанию (максимальное значение) — 50 предметов в одном ответе. Чтобы получать больше данных постранично, используйте параметры limit и offset.
", "operationId": "get-virtual-items-group", "parameters": [ { "$ref": "#/components/parameters/project-id-path-param" }, { "$ref": "#/components/parameters/external-id-path-param" }, { "$ref": "#/components/parameters/limit-query-param" }, { "$ref": "#/components/parameters/offset-query-param" }, { "$ref": "#/components/parameters/locale-query-param" }, { "$ref": "#/components/parameters/additional-fields-query-param" }, { "$ref": "#/components/parameters/country-query-param" } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "items": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] } ] } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_200_8" } } }, "description": "Список предметов из указанной группы успешно получен." }, "404": { "content": { "application/json": { "examples": { "response": { "value": { "errorCode": 4403, "errorMessage": "[0401-4403]: Item group not found", "statusCode": 404 } } }, "schema": { "$ref": "#/components/schemas/Catalog_inline_response_404_2" } } }, "description": "Группа не найдена. Убедитесь, что передан корректный `external_id`, группа не отключена и не удалена." } }, "security": [ { "AuthForClient": [] } ], "summary": "Получение списка предметов из указанной группы", "tags": [ "virtual items & currency" ] } } }, "components": { "securitySchemes": { "AuthForClient": { "description": "Используйте метод [Создать токен пользователя](https://developers.xsolla.com\\/ru/api/digital-distribution-hub/operation/create-user-token) для создания токена.", "scheme": "bearer", "type": "http" }, "basicAuth": { "description": "API Иксоллы использует базовую HTTP-аутентификацию. Все запросы к API должны содержать заголовок `Authorization: Basic `, где `your_authorization_basic_key` — это пара `distribution_hub_id:api_key`, закодированная по стандарту Base64. \n\nОбратитесь к аккаунт-менеджеру проекта, чтобы получить `distribution_hub_id` и `api_key`.", "scheme": "basic", "type": "http" } }, "parameters": { "project-id-path-param": { "description": "ID проекта.", "explode": false, "in": "path", "name": "project_id", "required": true, "schema": { "example": 44056, "type": "integer" }, "style": "simple" }, "currency-query-param": { "description": "Валюта, в которой отображаются цены (по умолчанию — USD). Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "explode": true, "in": "query", "name": "currency", "required": false, "schema": { "default": "USD", "type": "string" }, "style": "form" }, "locale-query-param": { "description": "Язык ответа. Используется двухбуквенное обозначение языка согласно стандарту ISO 639-1.", "explode": true, "in": "query", "name": "locale", "required": false, "schema": { "default": "en", "type": "string" }, "style": "form" }, "item-sku-path-param": { "description": "Артикул предмета.", "explode": false, "in": "path", "name": "item_sku", "required": true, "schema": { "example": "booster_mega_1", "type": "string" }, "style": "simple" }, "cart-id-path-param": { "description": "ID корзины.", "explode": false, "in": "path", "name": "cart_id", "required": true, "schema": { "example": "custom_id", "type": "string" }, "style": "simple" }, "order-id-path-param": { "description": "Идентификатор заказа.", "explode": false, "in": "path", "name": "order_id", "required": true, "schema": { "example": "656", "type": "string" }, "style": "simple" }, "limit-query-param": { "description": "Лимит количества элементов на странице.", "example": 50, "explode": true, "in": "query", "name": "limit", "required": false, "schema": { "example": 50, "type": "integer" }, "style": "form" }, "offset-query-param": { "description": "Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).", "example": 0, "explode": true, "in": "query", "name": "offset", "required": false, "schema": { "example": 0, "type": "integer" }, "style": "form" }, "additional-fields-query-param": { "description": "Список дополнительных полей. Эти поля будут в ответе, если вы отправите их в запросе. Доступные поля: `media_list`, `order`, `long_description`.", "explode": true, "in": "query", "name": "additional_fields[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" }, "style": "form" }, "country-query-param": { "description": "Страна для расчета региональных цен и ограничений для каталога. Используется двухбуквенное обозначение страны в верхнем регистре согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Если вы не укажете страну, она будет рассчитана на основе IP-адреса пользователя.", "explode": true, "in": "query", "name": "country", "required": false, "schema": { "default": "US", "type": "string" }, "style": "form" }, "sku-path-param": { "description": "Артикул бандла.", "explode": false, "in": "path", "name": "sku", "required": true, "schema": { "example": "kg_1", "type": "string" }, "style": "simple" }, "external-id-path-param": { "description": "Внешний идентификатор группы.", "explode": false, "in": "path", "name": "external_id", "required": true, "schema": { "default": "all", "type": "string" }, "style": "simple" } }, "schemas": { "Cart_admin-attribute-external_id": { "description": "Уникальный идентификатор атрибута. `external_id` может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "attribute_1", "maxLength": 255, "minLength": 1, "pattern": "^[a-zA-Z0-9-_]+$", "type": "string" }, "Cart_value-external_id": { "description": "Уникальный идентификатор атрибута. `external_id` может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "attribute_value", "maxLength": 255, "minLength": 1, "pattern": "^[-_.\\d\\w]+$", "type": "string" }, "Cart_clientattributes_inner": { "properties": { "external_id": { "$ref": "#/components/schemas/Cart_admin-attribute-external_id" }, "name": { "description": "Название атрибута.", "example": "Genre", "type": "string" }, "values": { "items": { "properties": { "external_id": { "$ref": "#/components/schemas/Cart_value-external_id" }, "value": { "description": "Значение атрибута.", "example": "Strategy", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Cart_client-attributes": { "default": [], "description": "Список атрибутов и их значений, соответствующих предмету. Может использоваться для фильтрации каталога.", "example": { "value": { "external_id": "genre", "name": "Жанр", "values": [ { "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85", "value": "Casual" }, { "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7", "value": "Strategy" }, { "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8", "value": "Mobile" } ] } }, "items": { "$ref": "#/components/schemas/Cart_clientattributes_inner" }, "type": "array" }, "Cart_inline_response_200_groups": { "properties": { "external_id": { "type": "string" }, "name": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Cart_client-attributes" }, "description": { "type": "string" }, "groups": { "items": { "$ref": "#/components/schemas/Cart_inline_response_200_groups" }, "type": "array" }, "image_url": { "type": "string" }, "is_free": { "type": "boolean" }, "name": { "nullable": true, "type": "string" }, "quantity": { "type": "integer" }, "sku": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_price": { "description": "Стоимость корзины.", "example": "{\"amount\":\"6150.0000000000000000\",\"amount_without_discount\":\"6150.0000000000000000\",\"currency\":\"USD\"}", "nullable": true, "properties": { "amount": { "default": "50.0000000000000000", "type": "string" }, "amount_without_discount": { "default": "100.0000000000000000", "type": "string" }, "currency": { "default": "USD", "type": "string" } }, "type": "object" }, "Cart_inline_response_200": { "properties": { "cart_id": { "description": "ID корзины.", "example": "cart_id", "type": "string" }, "is_free": { "description": "Если передано значение `true`, корзина бесплатная.", "type": "boolean" }, "items": { "example": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Cart_inline_response_200_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Cart_inline_response_200_price" } }, "type": "object" }, "Cart-Payment_settings_currency": { "description": "Предпочтительная валюта платежа. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "type": "string" }, "Cart_inline_response_200_1_warnings": { "properties": { "errorCode": { "type": "integer" }, "errorMessage": { "type": "string" }, "quantity": { "type": "integer" }, "sku": { "type": "string" } }, "type": "object" }, "Cart_inline_response_200_1": { "properties": { "cart_id": { "description": "ID корзины.", "example": "cart_id", "type": "string" }, "is_free": { "description": "Если передано значение `true`, корзина бесплатная.", "type": "boolean" }, "items": { "items": { "$ref": "#/components/schemas/Cart_inline_response_200_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Cart_inline_response_200_price" }, "warnings": { "example": [ { "attributes": [], "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.", "groups": [ { "external_id": "powerups", "name": "Power Ups" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Xsolla Booster Mega", "price": { "amount": "50.0000000000000000", "amount_without_discount": "100.0000000000000000", "currency": "USD" }, "quantity": 123, "sku": "booster_mega_1", "type": "virtual_good", "virtual_item_type": "consumable", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Cart_inline_response_200_1_warnings" }, "type": "array" } }, "type": "object" }, "Cart_inline_response_404": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with Project ID = 44056 and SKU = booster_mega_12222 not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Cart_inline_response_422_1": { "properties": { "errorCode": { "example": 1421, "type": "integer" }, "errorMessage": { "example": "This type of item cannot be put to the cart. Select another type of item.", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Cart_inline_response_422": { "properties": { "errorCode": { "example": 1102, "type": "integer" }, "errorMessage": { "example": "Item quantity must be non-negative integer.", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Order_inline_response_200_1_content_price_1": { "description": "Стоимость предмета.", "properties": { "amount": { "description": "Цена предмета со скидкой.", "example": "30", "type": "string" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": "30", "type": "string" }, "currency": { "description": "Валюта покупки по умолчанию. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_items": { "properties": { "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": "false", "type": "string" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_price_1" }, "quantity": { "description": "Количество этого предмета в заказе.", "example": 1, "type": "integer" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "some_sku", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_price": { "description": "Стоимость заказа.", "properties": { "amount": { "description": "Величина скидки на заказ.", "example": "30", "type": "string" }, "amount_without_discount": { "description": "Стоимость заказа.", "example": "30", "type": "string" }, "currency": { "description": "Валюта покупки по умолчанию. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content_virtual_price": { "description": "Стоимость заказа в виртуальной валюте.", "properties": { "amount": { "description": "Величина скидки на заказ.", "example": "100", "type": "string" }, "amount_without_discount": { "description": "Стоимость заказа.", "example": "150", "type": "string" }, "currency": { "description": "Артикул виртуальной валюты, используемый в заказе.", "example": "test_vc", "type": "string" } }, "type": "object" }, "Order_inline_response_200_1_content": { "description": "Детали заказа.", "properties": { "is_free": { "description": "Если передано значение `true`, заказ бесплатный.", "example": "false", "type": "string" }, "items": { "description": "Список предметов.", "example": [ { "is_free": false, "price": { "amount": "30", "amount_without_discount": "30", "currency": "USD" }, "quantity": 1, "sku": "some_sku" } ], "items": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_items" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_price" }, "virtual_price": { "$ref": "#/components/schemas/Order_inline_response_200_1_content_virtual_price" } }, "type": "object" }, "Order_inline_response_200_1": { "properties": { "content": { "$ref": "#/components/schemas/Order_inline_response_200_1_content" }, "order_id": { "description": "Идентификатор заказа.", "example": 1, "type": "integer" }, "status": { "description": "Статус заказа: `new` / `paid` / `done` / `canceled`.", "example": "paid", "type": "string" } }, "type": "object" }, "Order_inline_response_404": { "properties": { "errorCode": { "example": 9001, "type": "integer" }, "errorMessage": { "example": "[0401-9001]: Order not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Order_inline_response_200_billing_info_direct_tax": { "properties": { "amount": { "example": 150, "type": "number" }, "name": { "example": "TAX", "type": "string" }, "rate": { "example": 10, "type": "number" } }, "type": "object" }, "Order_inline_response_200_billing_info_indirect_tax": { "properties": { "amount": { "example": 246.75, "type": "number" }, "name": { "example": "VAT", "type": "string" }, "rate": { "example": 20, "type": "number" } }, "type": "object" }, "Order_inline_response_200_billing_info_price": { "properties": { "amount": { "example": 1480.45, "type": "number" }, "currency": { "description": "Валюта покупки. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "maxLength": 3, "minLength": 3, "type": "string" } }, "type": "object" }, "Order_inline_response_200_billing_info": { "description": "Платежная информация.", "properties": { "direct_tax": { "items": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_direct_tax" }, "type": "array" }, "indirect_tax": { "items": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_indirect_tax" }, "type": "array" }, "price": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info_price" } }, "type": "object" }, "Order_inline_response_200": { "properties": { "billing_info": { "$ref": "#/components/schemas/Order_inline_response_200_billing_info" }, "order_id": { "description": "Идентификатор заказа.", "type": "integer" } }, "type": "object" }, "Order_inline_response_422": { "properties": { "errorCode": { "example": 1401, "type": "integer" }, "errorMessage": { "example": "[0401-1401]: Invalid cart", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "Order_inline_response_422_1": { "properties": { "errorCode": { "example": 1411, "type": "integer" }, "errorMessage": { "example": "[0401-1411]: Invalid item", "type": "string" }, "statusCode": { "example": 422, "type": "integer" } }, "type": "object" }, "email-required": { "properties": { "country": { "description": "Двухбуквенный код страны в верхнем регистре согласно [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).", "example": "US", "nullable": true, "type": "string" }, "email": { "description": "Адрес электронной почты пользователя, на который он может получить купленный игровой ключ.", "example": "public_email@test.com", "type": "string" }, "id": { "description": "Уникальный идентификатор пользователя в игре.", "example": "public_id", "nullable": true, "type": "string" }, "ip": { "description": "IP-адрес пользователя.", "example": "127.0.0.1", "nullable": true, "type": "string" }, "name": { "description": "Имя пользователя в игре.", "example": "Public name", "nullable": true, "type": "string" }, "phone": { "description": "Номер телефона пользователя.", "example": "+66-000-000-00-00", "nullable": true, "type": "string" } }, "required": [ "email" ] }, "Common_inline_response_200_1": { "properties": { "token": { "description": "Токен пользователя.", "type": "string" } }, "type": "object" }, "Catalog_admin-attribute-external_id": { "description": "Уникальный идентификатор атрибута. `external_id` может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "attribute_1", "maxLength": 255, "minLength": 1, "pattern": "^[a-zA-Z0-9-_]+$", "type": "string" }, "Catalog_value-external_id": { "description": "Уникальный идентификатор атрибута. `external_id` может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "attribute_value", "maxLength": 255, "minLength": 1, "pattern": "^[-_.\\d\\w]+$", "type": "string" }, "Catalog_clientattributes_inner": { "properties": { "external_id": { "$ref": "#/components/schemas/Catalog_admin-attribute-external_id" }, "name": { "description": "Название атрибута.", "example": "Genre", "type": "string" }, "values": { "items": { "properties": { "external_id": { "$ref": "#/components/schemas/Catalog_value-external_id" }, "value": { "description": "Значение атрибута.", "example": "Strategy", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Catalog_client-attributes-common": { "default": [], "description": "Список атрибутов и их значений, соответствующих предмету. Может использоваться для фильтрации каталога.", "items": { "$ref": "#/components/schemas/Catalog_clientattributes_inner" }, "type": "array" }, "Catalog_bundle_type": { "description": "Тип бандла. Всегда принимает значение `standart`.", "example": "standart", "type": "string" }, "Catalog_client_content_inner": { "description": "Предмет в пакете.", "properties": { "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "price": { "description": "Стоимость предмета.", "nullable": true, "properties": { "amount": { "description": "Цена предмета со скидкой.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": "100.99", "type": "string" }, "currency": { "description": "Валюта покупки по умолчанию. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "quantity": { "description": "Количество предметов в пакете.", "example": 250, "type": "integer" }, "sku": { "description": "Уникальный идентификатор предмета (артикул). Может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "description": "Виртуальная цена.", "properties": { "amount": { "description": "Стоимость предмета в виртуальной валюте со скидкой.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": 200, "type": "integer" }, "description": { "description": "Описание виртуальной валюты.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "Изображение виртуальной валюты.", "example": "http://image.png", "type": "string" }, "is_default": { "description": "Является ли цена предмета ценой по умолчанию.", "example": true, "type": "boolean" }, "name": { "description": "Название виртуальной валюты.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Артикул виртуальной валюты.", "example": "vc_test", "type": "string" }, "type": { "description": "Тип виртуальной валюты.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Catalog_client_content": { "description": "Содержимое пакета бандлов.", "example": [ { "attributes": [], "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "items": { "$ref": "#/components/schemas/Catalog_client_content_inner" }, "type": "array" }, "Catalog_client_description": { "description": "Описание предмета.", "example": "Big Rocket - description.", "nullable": true, "type": "string" }, "Catalog_groups_response_inner": { "properties": { "external_id": { "example": "horror", "type": "string" }, "name": { "example": { "en": "Horror" }, "type": "object" } }, "type": "object" }, "Catalog_groups_response": { "default": [], "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "horror", "name": { "en": "Horror" } } ], "items": { "$ref": "#/components/schemas/Catalog_groups_response_inner" }, "type": "array" }, "Catalog_image_url": { "description": "URL изображения.", "example": "https://image.example.com", "nullable": true, "type": "string" }, "Catalog_is_free": { "default": "false", "description": "Всегда `false`.", "example": "false", "type": "string" }, "Catalog_client_name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "Catalog_amount": { "description": "Цена предмета со скидкой.", "example": "100.99", "pattern": "^\\d*\\.?\\d*$", "type": "string" }, "Catalog_amount_without_discount": { "description": "Стоимость предмета.", "example": "100.99", "pattern": "^\\d*\\.?\\d*$", "type": "string" }, "Catalog_currency": { "description": "Валюта покупки. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" }, "Catalog_price": { "description": "Стоимость предмета.", "nullable": true, "properties": { "amount": { "$ref": "#/components/schemas/Catalog_amount" }, "amount_without_discount": { "$ref": "#/components/schemas/Catalog_amount_without_discount" }, "currency": { "$ref": "#/components/schemas/Catalog_currency" } }, "required": [ "amount", "amount_without_discount", "currency" ], "type": "object" }, "Catalog_sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "bundle_1", "type": "string" }, "Catalog_total_content_price": { "description": "Общая стоимость содержимого бандла.", "nullable": true, "properties": { "amount": { "description": "Общая стоимость содержимого бандла со скидкой.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Общая стоимость содержимого бандла.", "example": "100.99", "type": "string" }, "currency": { "$ref": "#/components/schemas/Catalog_currency" } }, "type": "object" }, "Catalog_type": { "description": "Тип предмета.", "example": "bundle", "type": "string" }, "Catalog_virtual_prices_inner": { "description": "Виртуальная цена.", "properties": { "amount": { "description": "Стоимость предмета в виртуальной валюте со скидкой.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Цена предмета в виртуальной валюте.", "example": 200, "type": "integer" }, "description": { "description": "Описание виртуальной валюты.", "example": "Most popular gold", "nullable": true, "type": "string" }, "image_url": { "description": "Изображение виртуальной валюты.", "example": "http://image.png", "nullable": true, "type": "string" }, "is_default": { "description": "Является ли цена предмета ценой по умолчанию.", "example": true, "type": "boolean" }, "name": { "description": "Название виртуальной валюты.", "example": "Gold", "type": "string" }, "sku": { "description": "Артикул виртуальной валюты.", "example": "gold", "type": "string" }, "type": { "description": "Тип виртуальной валюты.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_virtual_prices_inner" }, "type": "array" }, "Catalog_client_bundle": { "description": "Указанный бандл.", "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "bundle_type": { "$ref": "#/components/schemas/Catalog_bundle_type" }, "content": { "$ref": "#/components/schemas/Catalog_client_content" }, "description": { "$ref": "#/components/schemas/Catalog_client_description" }, "groups": { "$ref": "#/components/schemas/Catalog_groups_response" }, "image_url": { "$ref": "#/components/schemas/Catalog_image_url" }, "is_free": { "$ref": "#/components/schemas/Catalog_is_free" }, "name": { "$ref": "#/components/schemas/Catalog_client_name" }, "price": { "$ref": "#/components/schemas/Catalog_price" }, "sku": { "$ref": "#/components/schemas/Catalog_sku" }, "total_content_price": { "$ref": "#/components/schemas/Catalog_total_content_price" }, "type": { "$ref": "#/components/schemas/Catalog_type" }, "virtual_prices": { "$ref": "#/components/schemas/Catalog_virtual_prices" } }, "type": "object" }, "Catalog_inline_response_200_10": { "description": "Объект с предметами.", "properties": { "items": { "items": { "$ref": "#/components/schemas/Catalog_client_bundle" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_groups": { "properties": { "external_id": { "example": "accessory", "type": "string" }, "name": { "example": "Accessory", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_price": { "description": "Стоимость предмета.", "properties": { "amount": { "description": "Цена предмета со скидкой.", "example": "2.9900", "type": "string" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": "2.9900", "type": "string" }, "currency": { "description": "Валюта покупки по умолчанию. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_virtual_prices": { "description": "Виртуальная цена.", "properties": { "amount": { "description": "Стоимость предмета в виртуальной валюте со скидкой.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": 200, "type": "integer" }, "description": { "description": "Описание виртуальной валюты.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "Изображение виртуальной валюты.", "example": "http://image.png", "type": "string" }, "is_default": { "description": "Является ли стоимость предмета стоимостью по умолчанию.", "example": true, "type": "boolean" }, "name": { "description": "Название виртуальной валюты.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Артикул виртуальной валюты.", "example": "vc_test", "type": "string" }, "type": { "description": "Тип виртуальной валюты.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_unit_items": { "properties": { "drm_name": { "description": "Название DRM.", "example": "Steam", "type": "string" }, "drm_sku": { "description": "Уникальный идентификатор DRM (артикул). Может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "steam", "type": "string" }, "has_keys": { "description": "Если передано значение `true`, у игры на платформе есть ключи для продажи.", "example": false, "type": "boolean" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Если передано значение `true`, игра на платформе доступна для предзаказа и дата выпуска еще не наступила.", "example": true, "type": "boolean" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Дата выпуска игры на платформе в формате ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "game_01", "type": "string" }, "type": { "description": "Тип предмета: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "description": { "description": "Описание предмета.", "example": "Game description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Game name", "type": "string" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "game_01", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.", "example": "unit", "type": "string" }, "unit_items": { "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_unit_items" }, "type": "array" }, "unit_type": { "description": "Тип единицы: `game`.", "example": "game", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200": { "description": "Объект с играми.", "properties": { "items": { "example": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, { "attributes": [ { "external_id": "OS", "name": "OS", "values": [ { "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723", "value": "Windows" } ] } ], "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_2", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_01", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_4_drm": { "properties": { "drm_id": { "description": "Идентификатор DRM.", "example": 1, "type": "number" }, "image": { "description": "URL изображения.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "link": { "description": "Ссылка на активацию.", "example": "https://support.us.playstation.com", "type": "string" }, "name": { "description": "Название DRM.", "example": "Steam", "type": "string" }, "redeem_instruction_link": { "description": "Ссылка на инструкцию по активации.", "example": "https://support.us.playstation.com", "type": "string" }, "sku": { "description": "Уникальный идентификатор DRM (артикул). Может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "steam", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_4": { "description": "Объект с играми.", "properties": { "drm": { "example": [ { "drm_id": 1, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "link": "https://support.steampowered.com", "name": "Steam", "redeem_instruction_link": "https://support.steampowered.com", "sku": "steam" }, { "drm_id": 2, "image": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Playstation", "redeem_instruction_link": "https://support.us.playstation.com", "sku": "playstation" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_4_drm" }, "type": "array" } }, "type": "object" }, "Catalog_client-attributes": { "default": [], "description": "Список атрибутов и их значений, соответствующих игре. \n\n
Обратите внимание. Эта часть ответа доступна только в том случае, если вы передадите `additional_fields[]=attributes` в параметре запроса.
", "items": { "$ref": "#/components/schemas/Catalog_clientattributes_inner" }, "type": "array" }, "Catalog_inline_response_200_3_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Описание предмета.", "example": "Game description", "type": "string" }, "drm_name": { "description": "Название DRM.", "example": "Steam", "type": "string" }, "drm_sku": { "description": "Уникальный идентификатор DRM (артикул). Может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "steam", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "has_keys": { "description": "Если передано значение `true`, у игры на платформе есть ключи для продажи.", "example": false, "type": "boolean" }, "image_url": { "description": "URL изображения.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Если передано значение `true`, игра на платформе доступна для предзаказа и дата выпуска еще не наступила.", "example": true, "type": "boolean" }, "name": { "description": "Наименование предмета.", "example": "Game name", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Дата выпуска игры на платформе в формате ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "game_01", "type": "string" }, "type": { "description": "Тип предмета: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_3": { "description": "Объект с играми.", "properties": { "items": { "example": [ { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": false, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_2", "type": "game_key", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_3_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_2": { "description": "Объект с информацией об игре на платформе.", "example": { "attributes": { "$ref": "#/components/examples/client-attribute-game-horror/Catalog_value" }, "description": "Game description", "drm_name": "Steam", "drm_sku": "steam", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "has_keys": true, "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "is_free": false, "is_pre_order": true, "name": "Game name", "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_1", "type": "game_key", "virtual_prices": [] }, "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes-common" }, "description": { "description": "Описание предмета.", "example": "Game description", "type": "string" }, "drm_name": { "description": "Название DRM.", "example": "Steam", "type": "string" }, "drm_sku": { "description": "Уникальный идентификатор DRM (артикул). Может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "steam", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "has_keys": { "description": "Если передано значение `true`, у игры на платформе есть ключи для продажи.", "example": false, "type": "boolean" }, "image_url": { "description": "URL изображения.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": false, "type": "boolean" }, "is_pre_order": { "description": "Если передано значение `true`, игра на платформе доступна для предзаказа и дата выпуска еще не наступила.", "example": true, "type": "boolean" }, "name": { "description": "Наименование предмета.", "example": "Game name", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_price" }, "release_date": { "description": "Дата выпуска игры на платформе в формате ISO 8601.", "example": "2020-08-11T10:00:00+03:00", "type": "string" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "game_01", "type": "string" }, "type": { "description": "Тип предмета: `game_key`.", "example": "game_key", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_404_1": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with sku = 'game_key_1' not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_1": { "description": "Объект с информацией об игре.", "example": { "attributes": { "$ref": "#/components/examples/client-attribute-game/Catalog_value" }, "description": "Game description", "groups": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla games" } ], "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "name": "Game name", "sku": "game_1", "type": "unit", "unit_items": [ { "drm_name": "Steam", "drm_sku": "steam", "has_keys": true, "is_free": false, "is_pre_order": true, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "release_date": "2020-08-11T10:00:00+03:00", "sku": "game_key_01", "type": "game_key", "virtual_prices": [] }, { "drm_name": "Origin", "drm_sku": "origin", "has_keys": false, "is_free": false, "is_pre_order": false, "price": { "amount": "30.5", "amount_without_discount": "30.5", "currency": "USD" }, "sku": "game_key_02", "type": "game_key", "virtual_prices": [] } ], "unit_type": "game" }, "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Описание предмета.", "example": "Game description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "all", "name": "All games" }, { "external_id": "Xsolla", "name": "Xsolla game" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Game name", "type": "string" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "game_01", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.", "example": "unit", "type": "string" }, "unit_items": { "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_unit_items" }, "type": "array" }, "unit_type": { "description": "Тип единицы: `game`.", "example": "game", "type": "string" } }, "type": "object" }, "Catalog_inline_response_404": { "properties": { "errorCode": { "example": 4001, "type": "integer" }, "errorMessage": { "example": "[0401-4001]: Item with sku = 'game_1' not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_9_children": { "properties": { "children": { "description": "Дочерние группы.", "example": [], "items": { "type": "string" }, "type": "array" }, "description": { "description": "Описание группы.", "example": "Accessory", "type": "string" }, "external_id": { "description": "Внешний идентификатор группы.", "example": "accessory", "type": "string" }, "image_url": { "description": "URL изображения.", "type": "string" }, "level": { "description": "Уровень вложенности группы.", "example": 2, "type": "integer" }, "name": { "description": "Название группы.", "example": "Accessory", "type": "string" }, "order": { "description": "Определяет порядок расположения.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "Внешний идентификатор родительской группы.", "example": "background", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9_children_1": { "properties": { "children": { "description": "Дочерние группы.", "example": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_children" }, "type": "array" }, "description": { "description": "Описание группы.", "example": "Background description", "type": "string" }, "external_id": { "description": "Внешний идентификатор группы.", "example": "background", "type": "string" }, "image_url": { "description": "URL-адрес изображения группы.", "type": "string" }, "level": { "description": "Уровень вложенности группы.", "example": 1, "type": "integer" }, "name": { "description": "Название группы.", "example": "Background", "type": "string" }, "order": { "description": "Определяет порядок расположения.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "Внешний идентификатор родительской группы.", "example": "hair", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9_groups": { "properties": { "children": { "description": "Дочерние группы.", "example": [ { "children": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "description": "Background description", "external_id": "background", "level": 1, "name": "Background", "order": 1, "parent_external_id": "hair" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_children_1" }, "type": "array" }, "description": { "description": "Описание группы.", "example": "Hair description", "type": "string" }, "external_id": { "description": "Внешний идентификатор группы.", "example": "hair", "type": "string" }, "image_url": { "description": "URL изображения.", "type": "string" }, "level": { "description": "Уровень вложенности группы.", "example": 0, "type": "integer" }, "name": { "description": "Название группы.", "example": "Hair", "type": "string" }, "order": { "description": "Определяет порядок расположения.", "example": 1, "type": "integer" }, "parent_external_id": { "description": "Внешний идентификатор родительской группы.", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_9": { "properties": { "groups": { "example": [ { "children": [ { "children": [ { "children": [], "description": "Accessory", "external_id": "accessory", "level": 2, "name": "Accessory", "order": 1, "parent_external_id": "background" } ], "description": "Background description", "external_id": "background", "level": 1, "name": "Background", "order": 1, "parent_external_id": "hair" } ], "description": "Hair description", "external_id": "hair", "level": 0, "name": "Hair", "order": 1 }, { "children": [], "description": "Super description", "external_id": "group_external_id", "level": 0, "name": "Super", "order": 1 } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_9_groups" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options_consumable": { "description": "Определяет, является ли предмет расходуемым или нерасходуемым, если передано значение `null`.", "nullable": true, "properties": { "usages_count": { "description": "Общее количество оставшихся использований, если это расходуемый предмет, или `null`, если это нерасходуемый предмет.", "example": 1, "nullable": true, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options_expiration_period": { "description": "Если у предмета есть период действия, в этом объекте определяются настройки этого периода. Передайте `null`, если у предмета нет ограничений по периоду действия.", "nullable": true, "properties": { "type": { "description": "Единица времени периода действия предмета.", "enum": [ "minute", "hour", "day", "week", "month", "year" ], "example": "day", "type": "string" }, "value": { "description": "Значение единицы времени периода действия предмета.", "example": 1, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_5_inventory_options": { "description": "Определяет варианты для предметов инвентаря.", "properties": { "consumable": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable" }, "expiration_period": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_expiration_period" } }, "type": "object" }, "Catalog_inline_response_200_5_price": { "description": "Стоимость предмета.", "properties": { "amount": { "description": "Цена предмета со скидкой.", "example": "100.99", "type": "string" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": "100.99", "type": "string" }, "currency": { "description": "Валюта покупки по умолчанию. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).", "example": "USD", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_6_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": "false", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "example": [ { "amount": 100, "amount_without_discount": 100, "image_url": "http://image.png", "is_default": true, "sku": "shotgun_raider" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_6": { "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "5" } ] } ], "description": "Big Rocket - short description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "1" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "value": "3.9" } ] }, { "external_id": "genre", "name": "Genre", "values": [ { "value": "Strategy" }, { "value": "Tactical" }, "Turn-based" ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_currency", "virtual_prices": [] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_currency", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_6_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_7_inventory_options_expiration_period": { "description": "Если у предмета есть период действия, в этом объекте определяются настройки этого периода. Передайте `null`, если у предмета нет ограничений по периоду действия.", "nullable": true, "properties": { "type": { "description": "Единица времени периода действия предмета.", "enum": [ "minute", "hour", "day", "week", "month", "year" ], "example": "day", "type": "string" }, "value": { "description": "Значение единицы времени периода действия предмета.", "example": 1, "type": "integer" } }, "type": "object" }, "Catalog_inline_response_200_7_inventory_options": { "description": "Определяет варианты для предметов инвентаря.", "properties": { "consumable": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options_consumable" }, "expiration_period": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options_expiration_period" } }, "type": "object" }, "Catalog_inline_response_200_7_content": { "description": "Виртуальная валюта в пакете.", "properties": { "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "quantity": { "description": "Количество виртуальной валюты в пакете.", "example": 250, "type": "integer" }, "sku": { "description": "Уникальный идентификатор предмета (артикул). Может содержать только строчные буквы латинского алфавита, цифры, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_7_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "bundle_type": { "description": "Тип бандла: `standard`/`virtual_currency_package`.", "example": "virtual_currency_package", "type": "string" }, "content": { "description": "Содержимое пакета виртуальной валюты.", "example": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_content" }, "type": "array" }, "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": "false", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.", "example": "bundle", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_7": { "description": "Объект с предметами.", "properties": { "items": { "example": [ { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "Big Rocket - short description", "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "Big Rocket", "quantity": 100, "sku": "big_rocket", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name first package", "price": { "amount": "2.0000", "amount_without_discount": "2.0000", "currency": "USD" }, "sku": "vc_package_1", "type": "bundle", "virtual_prices": [] }, { "attributes": [], "bundle_type": "virtual_currency_package", "content": [ { "description": "description", "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 } }, "name": "SHOTGUN FOR TRUE RAIDERS", "quantity": 200, "sku": "shotgun_raider", "type": "virtual_currency" } ], "description": "VC Short Package Description", "groups": [], "image_url": "http://vc_package_image.png", "is_free": false, "name": "VC Name third package", "price": { "amount": "4.0000", "amount_without_discount": "4.0000", "currency": "USD" }, "sku": "vc_package_3", "type": "bundle", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_inventory_options" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": false, "type": "boolean" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `virtual_good`/`virtual_currency`/`bundle`.", "example": "virtual_good", "type": "string" }, "virtual_item_type": { "description": "Тип виртуального предмета.", "enum": [ "consumable", "non_consumable", "non_renewing_subscription" ], "example": "non-consumable", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_5": { "description": "Объект с виртуальными предметами.", "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85", "value": "3.9" } ] } ], "description": "description", "groups": [ { "external_id": "hair", "name": "Hair" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] }, { "attributes": [], "description": "description", "groups": [], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "shotgun_raider_2", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_8_virtual_prices": { "description": "Виртуальная цена.", "properties": { "amount": { "description": "Стоимость предмета в виртуальной валюте со скидкой.", "example": 100, "type": "integer" }, "amount_without_discount": { "description": "Стоимость предмета.", "example": 200, "type": "integer" }, "description": { "description": "Описание виртуальной валюты.", "example": "Big Rocket - description", "type": "string" }, "image_url": { "example": "http://image.png", "type": "string" }, "is_default": { "description": "Является ли стоимость предмета стоимостью по умолчанию.", "example": true, "type": "boolean" }, "name": { "description": "Название виртуальной валюты.", "example": "SHOTGUN FOR TRUE RAIDERS", "type": "string" }, "sku": { "description": "Артикул виртуальной валюты.", "example": "vc_test", "type": "string" }, "type": { "description": "Тип виртуальной валюты.", "example": "virtual_currency", "type": "string" } }, "type": "object" }, "Catalog_inline_response_200_8_items": { "properties": { "attributes": { "$ref": "#/components/schemas/Catalog_client-attributes" }, "description": { "description": "Описание предмета.", "example": "Big Rocket - description", "type": "string" }, "groups": { "description": "Группы, к которым принадлежит предмет.", "example": [ { "external_id": "accessory", "name": "Accessory" } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_groups" }, "type": "array" }, "image_url": { "description": "URL изображения.", "example": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "type": "string" }, "inventory_options": { "$ref": "#/components/schemas/Catalog_inline_response_200_7_inventory_options" }, "is_free": { "description": "Если передано значение `true`, предмет бесплатный.", "example": "false", "type": "string" }, "name": { "description": "Наименование предмета.", "example": "Big Rocket", "type": "string" }, "price": { "$ref": "#/components/schemas/Catalog_inline_response_200_5_price" }, "sku": { "description": "Уникальный идентификатор предмета. Артикул может содержать только строчные буквы латинского алфавита, цифры, точки, дефисы и подчеркивания.", "example": "big_rocket", "type": "string" }, "type": { "description": "Тип предмета: `consumable`/`expiration`/`permanent`/`lootboxes`/`physical`.", "example": "virtual_good", "type": "string" }, "virtual_item_type": { "description": "Тип виртуального предмета.", "enum": [ "consumable", "non_consumable", "non_renewing_subscription" ], "example": "non_consumable", "type": "string" }, "virtual_prices": { "description": "Виртуальные цены.", "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_8_virtual_prices" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_200_8": { "properties": { "items": { "example": [ { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "5" } ] } ], "description": "Big Rocket - description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "Big Rocket", "price": { "amount": "100.99", "amount_without_discount": "100.99", "currency": "USD" }, "sku": "big_rocket", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" } ] }, { "attributes": [ { "external_id": "stack_size", "name": "Stack size", "values": [ { "value": "5" } ] }, { "external_id": "rating", "name": "Rating", "values": [ { "value": "3.9" } ] }, { "external_id": "genre", "name": "Genre", "values": [ { "value": "Strategy" }, { "value": "Tactical" }, "Turn-based" ] } ], "description": "description", "groups": [ { "external_id": "accessory", "name": "Accessory" } ], "image_url": "http://image.png", "inventory_options": { "consumable": { "usages_count": 1 }, "expiration_period": { "type": "day", "value": 1 } }, "is_free": false, "name": "SHOTGUN FOR TRUE RAIDERS", "price": { "amount": "101.0", "amount_without_discount": "101.0", "currency": "USD" }, "sku": "shotgun_raider", "type": "virtual_good", "virtual_item_type": "non_renewing_subscription", "virtual_prices": [ { "amount": 100, "amount_without_discount": 100, "description": "description", "image_url": "http://image.png", "is_default": true, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test", "type": "virtual_currency" }, { "amount": 200, "amount_without_discount": 200, "description": "description", "image_url": "http://image.png", "is_default": false, "name": "SHOTGUN FOR TRUE RAIDERS", "sku": "vc_test_2", "type": "virtual_currency" } ] } ], "items": { "$ref": "#/components/schemas/Catalog_inline_response_200_8_items" }, "type": "array" } }, "type": "object" }, "Catalog_inline_response_404_2": { "properties": { "errorCode": { "example": 4403, "type": "integer" }, "errorMessage": { "example": "[0401-4403]: Item group not found", "type": "string" }, "statusCode": { "example": 404, "type": "integer" } }, "type": "object" } }, "requestBodies": { "fill-cart-json-model": { "content": { "application/json": { "schema": { "example": [ { "quantity": 123, "sku": "booster_mega_1" } ], "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "items": { "description": "Список предметов.", "items": { "minItems": 1, "properties": { "quantity": { "default": 123, "type": "number" }, "sku": { "default": "booster_mega_1", "type": "string" } }, "required": [ "quantity", "sku" ], "type": "object" }, "type": "array" } }, "required": [ "items" ], "type": "object" } } } }, "put-item-by-cart-id-json-model": { "content": { "application/json": { "schema": { "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "quantity": { "default": 123, "description": "Количество этого предмета в заказе.", "type": "number" } }, "type": "object" } } } }, "create-order-model": { "content": { "application/json": { "schema": { "example": { "geotype": 13038 }, "properties": { "currency": { "$ref": "#/components/schemas/Cart-Payment_settings_currency" }, "geotype": { "description": "Идентификатор партнера-дистрибьютора на стороне Иксоллы.", "type": "number" }, "quantity": { "description": "Количество этого предмета в заказе.", "example": 1, "type": "integer" } }, "required": [ "geotype", "currency" ], "type": "object" } } }, "description": "Объект с данными для создания заказа.", "required": true }, "post-user-token-json-model": { "content": { "application/json": { "schema": { "properties": { "user": { "$ref": "#/components/schemas/email-required", "description": "Объект с информацией о пользователе.", "type": "object" } }, "required": [ "user" ], "type": "object" } } } } }, "examples": { "200-get-bundle-list": { "value": { "items": [ { "attributes": { "external_id": "genre", "name": "Genre", "values": [ { "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85", "value": "Casual" }, { "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7", "value": "Strategy" }, { "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8", "value": "Mobile" } ] }, "bundle_type": "standard", "content": [ { "attributes": { "external_id": "size", "name": "Size", "values": [ { "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85", "value": "Large" } ] }, "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency", "virtual_item_type": "non_consumable", "virtual_prices": [] } ], "description": "pricePoint_44056_1", "groups": [], "is_free": false, "media_list": [], "name": "kg_10.00_bundle", "order": 999, "price": { "amount": 9.99, "amount_without_discount": 9.99, "currency": "USD" }, "sku": "kg_1", "total_content_price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "type": "bundle", "virtual_prices": [] } ] } }, "200-get-bundle": { "value": { "attributes": [], "bundle_type": "standard", "content": [ { "attributes": [], "description": "Big Rocket - short description.", "groups": [], "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png", "is_free": false, "name": "Big Rocket", "price": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "quantity": 100, "sku": "big_rocket", "type": "virtual_currency", "virtual_prices": [] } ], "description": "pricePoint_44056_1.", "groups": [], "is_free": false, "media_list": [], "name": "kg_10.00_bundle", "order": 999, "price": { "amount": 9.99, "amount_without_discount": 9.99, "currency": "USD" }, "sku": "kg_1", "total_content_amount": { "amount": 10.99, "amount_without_discount": 10.99, "currency": "USD" }, "type": "bundle", "virtual_prices": [] } } } }, "x-tagGroups": [ { "name": "Корзина", "tags": [ "cart" ] }, { "name": "Каталог", "tags": [ "game keys", "virtual items & currency", "bundles" ] }, { "name": "Общие", "tags": [ "user token" ] }, { "name": "Уведомления", "tags": [ "notifications" ] }, { "name": "Заказ", "tags": [ "order" ] } ] }