# Catalog API

# Overview

* **Version:** 2.0.0
* **Servers**: `https://store.xsolla.com/api`
* **[Contact Us by Email](mailto:integration@xsolla.com)**
* **Contact URL:** https://xsolla.com/
* **Required TLS version:** 1.2

Catalog API предоставляет методы для управления каталогом вашего внутриигрового магазина и обработки покупок. Используйте методы для настройки виртуальных предметов, виртуальных валют, игровых ключей, бандлов, процессов корзины и оплаты, атрибутов товаров, а также для импорта товаров из внешних источников. 

Version: 2.0.0

## Servers

```
https://store.xsolla.com/api
```

## Security

### AuthForCart

При продаже корзины с играми вы можете [вызвать соответствующий метод без авторизации](/ru/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users).

Для этого:

* Добавьте уникальный идентификатор к параметру `x-unauthorized-id` в хедере для игр.
* Добавьте адрес электронной почты пользователя в параметр `x-user` (в кодировке Base64) в хедере для игр.

По умолчанию для авторизации используется JWT пользователя Авторизации Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`.

В качестве альтернативы вы можете использовать [Pay Station access token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/).

Type: http
Scheme: bearer

### XsollaLoginUserJWT

По умолчанию для авторизации используется JWT пользователя Авторизации Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`.

В качестве альтернативы вы можете использовать [Pay Station access token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/).

Type: http
Scheme: bearer
Bearer Format: JWT

### basicAuth

Xsolla API использует базовую аутентификацию. Все запросы к API должны содержать заголовок `Authorization: Basic <your_authorization_basic_key>`, где `your_authorization_basic_key` — пара `project_id:api_key`, закодированная по стандарту Base64.

Вы можете использовать `merchant_id` вместо, `project_id` при необходимости. Это не влияет на функциональность.

Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/):

* `merchant_id` отображается:
  * В разделе **Настройки компании > Компания**
  * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>`.
* `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
  * **Настройки компании > Ключи API**
  * **Настройки проекта > Ключи API**
* `project_id` отображается:
  * В Личном кабинете рядом с названием проекта.
  * В URL-адресе в адресной строке браузера при работе над проектом в учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.

Подробная информация о работе с ключами API приведена в [справочнике API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview).

Type: http
Scheme: basic

### basicMerchantAuth

Xsolla API использует базовую аутентификацию. Все запросы к API должны содержать заголовок `Authorization: Basic <your_authorization_basic_key>`, где `your_authorization_basic_key` — пара `merchant_id:api_key`, закодированная по стандарту Base64.

Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/):

* `merchant_id` отображается:
  * В разделе **Настройки компании > Компания**
  * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>`
* `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
  * **Настройки компании > Ключи API**
  * **Настройки проекта > Ключи API**

Подробная информация о работе с ключами API приведена в [справочнике API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview).

Type: http
Scheme: basic

## Download OpenAPI description

[Catalog API](https://developers.xsolla.com/_bundle/@l10n/ru/api/catalog/index.yaml)

## Admin

### Получение списка виртуальных валют

 - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): Получает список виртуальных валют в рамках проекта для администрирования.

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

### Создание виртуальной валюты

 - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency.md): Создает виртуальную валюту.

### Получение списка пакетов виртуальной валюты (admin)

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): Получает список пакетов виртуальной валюты в рамках проекта для администрирования.

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

### Создание пакета виртуальной валюты

 - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-create-virtual-currency-package.md): Создает пакет виртуальной валюты.

### Удаление пакета виртуальной валюты

 - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): Удаляет пакет виртуальной валюты.

### Получение пакета виртуальной валюты

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency-package.md): Получает пакет виртуальной валюты в рамках проекта для администрирования.

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

### Обновление пакета виртуальной валюты

 - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency-package.md): Обновляет пакет виртуальной валюты.

### Удаление виртуальной валюты

 - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-delete-virtual-currency.md): Удаляет виртуальную валюту.

### Получение виртуальной валюты

 - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-currency.md): Получает виртуальную валюту в рамках проекта для администрирования.

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

### Обновление виртуальной валюты

 - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-update-virtual-currency.md): Обновляет виртуальную валюту.

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

 - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list.md): Получает список виртуальных предметов в рамках проекта для администрирования.

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

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

 - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-create-virtual-item.md): Создает виртуальный предмет.

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

 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): Получает список виртуальных предметов в рамках группы для администрирования.

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

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

 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): Получает список виртуальных предметов в рамках группы для администрирования.

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

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

 - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-delete-virtual-item.md): Удаляет виртуальный предмет.

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

 - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-item.md): Получает виртуальный предмет в рамках проекта для администрирования.

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

### Обновление виртуального предмета

 - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-admin/admin-update-virtual-item.md): Обновляет виртуальный предмет.

## Catalog

### Получение списка групп товаров

 - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-item-groups.md): Получает список групп товаров для создания каталога.

### Получение списка виртуальных валют

 - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency.md): Получает список виртуальных валют для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение списка пакетов виртуальной валюты

 - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package.md): Получает список пакетов виртуальной валюты для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение пакета виртуальной валюты по артикулу

 - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): Получает пакет виртуальной валюты по артикулу для построения каталога.
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

### Получение виртуальной валюты по артукулу

 - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-currency-sku.md): Получает виртуальную валюту по артикулу для построения каталога.
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

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

 - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items.md): Получает список виртуальных предметов для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

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

 - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-all-virtual-items.md): Gets a list of all virtual items for searching on client-side.

AttentionReturns only item SKU, name, groups and description  NoteThe use of the item catalog API calls is available without authorization, but to get a personalized catalog, you must pass the user JWT in the Authorization header.

### Получение списка товаров по указанной группе

 - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items-group.md): Получает список товаров из указанной группы для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

### Получение виртуального предмета по артикулу

 - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items-sku.md): Получает виртуальный предмет по артикулу для построения каталога.
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

## Виртуальная оплата

### Создание заказа с указанным товаром, приобретенным за виртуальную валюту

 - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/ru/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency.md): Создает покупку товара с использованием виртуальной валюты.

## Catalog

### Получение списка игр

 - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-games-list.md): Получает список игр для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение списка платформ

 - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-drm-list.md): Получает список доступных платформ.

### Получение списка игр по указанной группе

 - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-games-group.md): Получает список игр из указанной группы для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации,но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение списка игровых ключей по указанной группе

 - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-game-keys-group.md): Получает список игровых ключей из указанной группы для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение игрового ключа для каталога

 - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-game-key-by-sku.md): Получает иговой ключ для каталога.

ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

### Получение игры для каталога

 - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-catalog/get-game-by-sku.md): Получает игру для каталога. 

ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

## Владение играми

### Предоставление права владения (admin)

 - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/ru/api/catalog/game-keys-entitlement/grant-entitlement-admin.md): Дает пользователю право владения.

ВниманиеМогут быть предоставлены только игровые ключи или игры для DRM-free-платформ.

### Отзыв права владения (admin)

 - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/ru/api/catalog/game-keys-entitlement/revoke-entitlement-admin.md): Отзывает право владения у пользователя.

ВниманиеМогут быть отозваны только игровые ключи или игры для DRM-free-платформ.

### Получение списка игр, принадлежащих пользователю

 - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/ru/api/catalog/game-keys-entitlement/get-user-games.md): Получает список игр, принадлежащих пользователю. Ответ будет содержать массив игр, принадлежащих определенному пользователю.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ.Чтобы получить больше данных постранично, используйте поля limit и offset.

### Активация игрового ключа на стороне клиента

 - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ru/api/catalog/game-keys-entitlement/redeem-game-pin-code.md): Дает право владения по предоставленному игровому коду.

ВниманиеМогут быть погашены только игровые коды для DRM-free-платформ.

## Admin

### Получение списка игр (admin)

 - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-game-list.md): Получает список игр в рамках проекта для администрирования.
Игра состоит из игровых ключей, которые могут быть приобретены пользователем.

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

### Создание игры

 - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-create-game.md): Создает игру в проекте.

### Удаление игры по ID

 - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-delete-game-by-id.md): Удаляет игру в проекте по ID.

### Получение игры по ID (admin)

 - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-game-by-id.md): Получает игру для администрирования.
Игра состоит из игровых ключей, которые могут быть приобретены пользователем.

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

### Обновление игры по ID

 - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-update-game-by-id.md): Обновляет игру в проекте по ID.

### Удаление кодов по ID

 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-delete-codes-by-id.md): Удаляет все коды по ID игрового ключа.

### Удаление кодов

 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-delete-codes-by-sku.md): Удаляет все коды по артикулу игрового ключа.

### Получение кодов по ID

 - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-codes-by-id.md): Получает определенное количество кодов по ID игрового ключа.

### Получение кодов

 - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-codes-by-sku.md): Получает определенное количество кодов по артикулу игрового ключа.

### Загрузка кодов по ID

 - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-upload-codes-by-id.md): Загружает коды по ID игрового ключа.

### Получение информации о сеансе загрузки кодов

 - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-codes-session.md): Получает информацию о сеансе загрузки кодов.

### Загрузка кодов

 - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-upload-codes-by-sku.md): Загружает коды по артикулу игрового ключа.

### Удаление игры по артикулу

 - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-delete-game-by-sku.md): Удаляет игру в проекте по артикулу.

### Получение игры (admin)

 - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-get-game-by-sku.md): Получает игру для администрирования.
Игра состоит из игровых ключей, которые могут быть приобретены пользователем.

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

### Обновление игры по артикулу

 - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/game-keys-admin/admin-update-game-by-sku.md): Обновляет игру в проекте по артикулу.

## Admin

### Получение списка бандлов

 - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-get-bundle-list.md): Получает список бандлов в рамках проекта для администрирования.

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

### Создание бандла

 - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-create-bundle.md): Создает бандл.

### Получение списка бандлов по указанному External ID группы

 - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): Получает список бандлов в рамках группы для администрирования.

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

### Получение списка бандлов по указанному ID группы

 - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-get-bundle-list-in-group-by-id.md): Получает список бандлов в рамках группы для администрирования.

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

### Удаление бандла

 - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-delete-bundle.md): Удаляет бандл.

### Получение бандла

 - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-get-bundle.md): Получает бандл в рамках проекта для администрирования.

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

### Обновление бандла

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-update-bundle.md): Обновляет бандл.

### Скрытие бандла в каталоге

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-hide-bundle.md): Скрывает бандл в каталоге.

### Отображение бандла в каталоге

 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/ru/api/catalog/bundles-admin/admin-show-bundle.md): Показывает бандл в каталоге.

## Catalog

### Получение списка бандлов

 - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ru/api/catalog/bundles-catalog/get-bundle-list.md): Получает список бандлов для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 элементов на ответ.   ПримечаниеИспользование каталога товаров доступно без авторизации,но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение списка бандлов по указанной группе

 - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/ru/api/catalog/bundles-catalog/get-bundle-list-in-group.md): Получает список бандлов в рамках группы для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 элементов на ответ.   ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение указанного бандла

 - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ru/api/catalog/bundles-catalog/get-bundle.md): Получает указанный бандл.

ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

## Корзина (на стороне клиента)

### Получение корзины текущего пользователя

 - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ru/api/catalog/cart-client-side/get-user-cart.md): Возвращает корзину текущего пользователя.

### Удаление всех товаров из текущей корзины

 - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ru/api/catalog/cart-client-side/cart-clear.md): Удаляет все товары из корзины.

### Наполнение корзины товарами

 - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ru/api/catalog/cart-client-side/cart-fill.md): Наполняет корзину товарами. Если в корзине уже есть товар с тем же артикулом, существующий товар будет заменен переданным значением.

### Удаление товара из текущей корзины

 - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/cart-client-side/delete-item.md): Удаляет товар из корзины.

### Обновление товара из текущей корзины

 - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/cart-client-side/put-item.md): Обновляет уже имеющийся в корзине товар или создает его в корзине.

### Получение корзины по ID корзины

 - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ru/api/catalog/cart-client-side/get-cart-by-id.md): Возвращает корзину пользователя по ID корзины.

### Удаление всех товаров из корзины по ID корзины

 - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/ru/api/catalog/cart-client-side/cart-clear-by-id.md): Удаляет все товары из корзины.

### Наполнение определенной корзины товарами

 - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ru/api/catalog/cart-client-side/cart-fill-by-id.md): Наполняет определенную корзину товарами. Если в корзине уже есть товар с тем же артикулом, существующая позиция товара будет заменен переданным значением.

### Удаление товара из корзины по ID корзины

 - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/cart-client-side/delete-item-by-cart-id.md): Удаляет товар из корзины.

### Обновление товара в корзине по ID корзины

 - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/cart-client-side/put-item-by-cart-id.md): Обновляет уже имеющийся в корзине товар или создает его в корзине.

## Корзина (на стороне сервера)

### Наполнение корзины товарами

 - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/ru/api/catalog/cart-server-side/admin-cart-fill.md): Заполняет текущую корзину товарами. Если в корзине уже есть товар с таким же артикулом, существующий товар будет заменен на переданное значение.

### Наполнение корзины по ID корзины товарами

 - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ru/api/catalog/cart-server-side/admin-fill-cart-by-id.md): Заполняет корзину товарами по идентификатору корзины. Если в корзине уже есть товар с таким же артикулом, существующий товар будет заменен на переданное значение.

## Оплата (на стороне клиента)

### Создание заказа со всеми товарами из текущей корзины

 - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/ru/api/catalog/payment-client-side/create-order.md): Используется для интеграции клиент-сервер. Создает заказ со всеми товарами из корзины и генерирует для него токен оплаты. Созданный заказ получает new статус заказа.

IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа.

Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен.

Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}.

Внимание Поскольку этот метод использует IP-адрес для определения страны пользователя и валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station.

### Создание заказа со всеми товарами из определенной корзины

 - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/ru/api/catalog/payment-client-side/create-order-by-cart-id.md): Используется для интеграции клиент-сервер. Создает заказ со всеми товарами из конкретной корзины и генерирует для него токен оплаты. Созданный заказ получает статус заказа new.

IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа.

Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен.

Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}.

ПримечаниеПоскольку этот метод использует IP-адрес для определения страны пользователя и выбора валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station.

### Создание заказа с указанным товаром

 - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/payment-client-side/create-order-with-item.md): Используется для интеграции клиент-сервер. Создает заказ с указанным товаром и генерирует для него токен оплаты. Созданный заказ получает статус заказа new.

IP-адрес клиента используется для определения страны пользователя, которая затем используется для применения соответствующей валюты и доступных способов оплаты заказа.

Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен.

Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}.

ПримечаниеПоскольку этот метод использует IP-адрес для определения страны пользователя и выбора валюты для заказа, важно использовать этот метод только на стороне клиента, а не на стороне сервера. Использование этого метода на стороне сервера может привести к неправильному определению валюты и повлиять на способы оплаты в Pay Station.

## Оплата (на стороне сервера)

### Создание платежного токена для покупки

 - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/ru/api/catalog/payment-server-side/admin-create-payment-token.md): Генерирует заказ и платежный токен для него. Заказ генерируется на основе товаров, переданных в теле запроса.

Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен.

Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}.

 Внимание

Параметр user.country.value используется для выбора валюты для заказа. Если страна пользователя неизвестна, 
альтернативным вариантом является указание IP-адреса пользователя в X-User-Ip заголовке. Для корректной работы метода требуется один из этих двух вариантов. Выбранная валюта используется для оплаты в Pay Station.

## Заказ

### Получение заказа

 - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/ru/api/catalog/order/get-order.md): Получает указанный заказ.

### Получение списка заказов за указанный период

 - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/ru/api/catalog/order/admin-order-search.md): Возвращает список заказов, упорядоченный по дате создания — от самой ранней до самой поздней.

## Бесплатные товары

### Создание заказа с помощью бесплатной корзины

 - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/ru/api/catalog/free-item/create-free-order.md): Создает заказ со всеми товарами из бесплатной корзины. Созданному заказу будет присвоен статус заказа done.

### Создание заказа с помощью определенной бесплатной корзины

 - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/ru/api/catalog/free-item/create-free-order-by-cart-id.md): Создает заказ со всеми товарами из определенной бесплатной корзины. Созданному заказу будет присвоен статус заказа done.

### Создание заказа с указанным бесплатным товаром

 - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/ru/api/catalog/free-item/create-free-order-with-item.md): Создает заказ с указанным бесплатным товаром. Созданному заказу будет присвоен статус заказа done.

## Управление

### Обновление всех лимитов на покупку для пользователя

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/reset-all-user-items-limit.md): Обновляет все лимиты на покупку для всех товаров для указанного пользователя, чтобы он мог приобрести эти товары снова.

API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

### Уменьшение лимита доступных пользователю товаров

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/remove-user-item-limit.md): Уменьшает оставшееся количество товаров, доступных указанному пользователю в пределах установленного лимита.

API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
*Виртуальные предметы и валюта
* Бандлы

### Получение лимита доступных пользователю товаров

 - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/get-user-item-limit.md): Возвращает оставшееся количество товаров, доступных указанному пользователю, в пределах установленного ограничения.

 User limit API позволяет вам продавать товар в ограниченном количестве. Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

### Увеличение лимита доступных пользователю товаров

 - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/add-user-item-limit.md): Увеличивает оставшееся количество товаров, доступных указанному пользователю, в пределах установленного ограничения.

User limit API позволяет продавать товар в ограниченном количестве. Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

### Настройка лимита доступных пользователю товаров

 - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/set-user-item-limit.md): Устанавливает количество товаров, которые указанный пользователь может купить в пределах ограничения, примененного после его увеличения или уменьшения.

User limit API позволяет продавать товар в ограниченном количестве. Чтобы настроить ограничения покупку, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

### Обновление лимита на покупку

 - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ru/api/catalog/user-limits-admin/reset-user-item-limit.md): Обновляет лимит на покупку товара, чтобы пользователь мог купить его снова. Если параметр user равен null, этот метод обновляет лимит для всех пользователей.

API лимитов на покупку позволяет вам продавать товар в ограниченном количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin нужного типа товара:
* Игровые ключи
*Виртуальные предметы и валюта
* Бандлы

## Admin

### Получение статуса импорта товаров

 - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/ru/api/catalog/connector-admin/get-items-import-status.md): Возвращает информацию о прогрессе импорта товаров в проект. Метод возвращает данные по последнему импорту,  выполненному через API или Личный кабинет.

### Импорт товаров из JSON-файла

 - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/ru/api/catalog/connector-admin/import-items-from-external-file.md): Импортирует товары в магазин из JSON-файла по указанному URL-адресу. Подробная информация об импорте из JSON-файла приведена в документации.

## Вебхуки

### Получение информации о настройках вебхуков

 - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ru/api/catalog/common-webhooks/get-webhook.md): Получает информацию о настройках вебхуков в Store.
 Подробная информация о настройке вебхуков приведена в документации.

### Обновление информации о настройках вебхуков

 - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ru/api/catalog/common-webhooks/update-webhook.md): Обновляет информацию о настройках вебхуков в Store.
 Подробная информация о настройке вебхуков приведена в документации.

## Предзаказы

### Уменьшение лимита предзаказа товара

 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/remove-pre-order-limit.md): Удаляет ограничение на количество предзаказа товара. 

Pre-Order limit API позволяет продавать товар в ограниченном количестве. Для настройки самого предзаказа перейдите в раздел Admin желаемого товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Алиасы для данного эндпоинта:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### Получение информации о лимите предзаказа товара

 - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/get-pre-order-limit.md): Возвращает ограничение на предзаказ товара.

Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Aliases для этой конечной точки:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### Увеличение лимита предзаказа товара

 - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/add-pre-order-limit.md): Добавляет количество к ограничению на предзаказ товара.

Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Aliases для этой конечной точки:
*/v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### Установка/обновление лимита предзаказа товара

 - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/set-pre-order-limit.md): Устанавливает ограничение на количество товара для предварительного заказа.

Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Aliases для этой конечной точки:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}

### Обнуление лимита предзаказа товара

 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/remove-all-pre-order-limit.md): Удаляет все ограничения по количеству товара, предусмотренные для предварительного заказа.

Pre-Order limit API позволяет вам продавать товар в ограниченном количестве. Для настройки самого предварительного заказа перейдите в раздел администратора модуля нужного товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Aliases для этой конечной точки:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all

### Включение/отключение лимита предзаказа товара

 - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/ru/api/catalog/common-pre-orders/toggle-pre-order-limit.md): Включает/отключает лимит предзаказа товара. 

API лимитов для предзаказов позволяет продавать товар в ограниченном количестве. Для настройки самого предзаказа перейдите в раздел Admin желаемого товара:
* Игровые ключи
* Виртуальные предметы и валюта
* Бандлы

Алиасы для данного метода:
* /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle

## Продавец

### Получение проектов

 - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/ru/api/catalog/common-merchant/get-projects.md): Получает список проектов мерчанта.


 Внимание Этот метод API не включает в себя path-параметр project_id, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах.

## Catalog

Данный API позволяет получать продаваемые товары любого вида или конкретный товар.

### Получение списка продаваемых товаров

 - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/ru/api/catalog/common-catalog/get-sellable-items.md): Получает список продаваемых товаров для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ.Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение списка продаваемых товаров по указанной группе

 - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/ru/api/catalog/common-catalog/get-sellable-items-group.md): Получает список продаваемых товаров из указанной группы для построения каталога.

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров. Чтобы получить больше данных постранично, используйте поля limit и offset.  ПримечаниеИспользование каталога товаров доступно без авторизации, но для получения персонализированного каталога необходимо передать JWT пользователя в заголовке Authorization.

### Получение продаваемого товара по ID

 - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/ru/api/catalog/common-catalog/get-sellable-item-by-id.md): Получает продаваемый товар по его ID. 
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

### Получение продаваемого товара по артикулу

 - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/ru/api/catalog/common-catalog/get-sellable-item-by-sku.md): Получает продаваемый товар по артикулу для построения каталога.
ПримечаниеБез авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.

## Общие регионы

### Получение списка регионов

 - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ru/api/catalog/common-regions/admin-get-regions.md): Получает список регионов.

 Вы можете использовать регион для управления вашими региональными ограничениями.

### Создание региона

 - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ru/api/catalog/common-regions/admin-create-region.md): Создает регион.

 Вы можете использовать регион для управления вашими региональными ограничениями.

### Удаление региона

 - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/catalog/common-regions/admin-delete-region.md): Удаляет определенный регион.

### Получение региона

 - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/catalog/common-regions/admin-get-region.md): Получает определенный регион.

 Вы можете использовать регион для управления вашими региональными ограничениями.

### Обновление региона

 - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ru/api/catalog/common-regions/admin-update-region.md): Обновляет определенный регион.

 Вы можете использовать регион для управления вашими региональными ограничениями.

## Admin

### Получение списка атрибутов (admin)

 - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-get-attribute-list.md): Получает список атрибутов из проекта для администрирования.

### Создание атрибута

 - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-create-attribute.md): Создает атрибут.

### Удаление атрибута

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/catalog/attribute-admin/delete-attribute.md): Удаляет атрибут.
ВниманиеЕсли вы удалите атрибут товара, все его данные и связи с товарами будут удалены.

### Получение указанного атрибута

 - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-get-attribute.md): Получает указанный атрибут.

### Обновление атрибута

 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-update-attribute.md): Обновляет атрибут.

### Удаление всех значений атрибута

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-delete-all-attribute-value.md): Удаляет все значения атрибута.
ВниманиеЕсли вы удалите значение атрибута, связь атрибута с товарами будет потеряна. Чтобы изменить значение атрибута для товара, используйте метод Обновление значения атрибута вместо удаления значения и создания нового.

### Создание значения атрибута

 - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-create-attribute-value.md): Создает значение атрибута.

ВниманиеВсе проекты имеют ограничение на количество значений атрибута. Значение по умолчанию и максимальное значение — 20 значений для каждого атрибута.

### Удаление значения атрибута

 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-delete-attribute-value.md): Удаляет значение атрибута.
ВниманиеЕсли вы удалите значение атрибута, связь атрибута с товарами будет потеряна. Чтобы изменить значение атрибута для товара, используйте метод Обновление значения атрибута вместо удаления значения и создания нового.

### Обновление значения атрибута

 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ru/api/catalog/attribute-admin/admin-update-attribute-value.md): Обновляет значения атрибута.