# LiveOps 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 LiveOps 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` — пара `project_id:api_key`, закодированная по стандарту Base64. Вы можете использовать `merchant_id` вместо, `project_id` при необходимости. Это не влияет на функциональность. Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/): * `merchant_id` отображается: * В разделе **Настройки компании > Компания** * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/`. * `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах: * **Настройки компании > Ключи API** * **Настройки проекта > Ключи API** * `project_id` отображается: * В Личном кабинете рядом с названием проекта. * В URL-адресе в адресной строке браузера при работе над проектом в учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com//projects/`. Подробная информация о работе с ключами 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` — пара `merchant_id:api_key`, закодированная по стандарту Base64. Значения параметров вы можете найти в [Личном кабинете](https://publisher.xsolla.com/): * `merchant_id` отображается: * В разделе **Настройки компании > Компания** * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/` * `api_key` отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах: * **Настройки компании > Ключи API** * **Настройки проекта > Ключи API** Подробная информация о работе с ключами API приведена в [справочнике API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [LiveOps API](https://developers.xsolla.com/_bundle/@l10n/ru/api/liveops/index.yaml) ## Общие ### Активация акции - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/ru/api/liveops/promotions-common/activate-promotion.md): Активирует акцию. ### Деактивация акции - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/ru/api/liveops/promotions-common/deactivate-promotion.md): Деактивирует акцию. ### Подтвердите промокод - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/ru/api/liveops/promotions-common/verify-promotion-code.md): Определяет, является ли код промокодом или купоном и может ли пользователь его применить. ### Получение списка всех акций - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/ru/api/liveops/promotions-common/get-promotion-list.md): Получает список акций проекта. ### Информация об акции с кодом - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/ru/api/liveops/promotions-common/get-redeemable-promotion-by-code.md): Получение акции по промокоду или коду купона. ## Купоны Этот API позволяет вам управлять купонами. ### Получение ограничений для уникальных кодов купонов - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupon-code-limit.md): Возвращает оставшееся количество применений кодов. Для фильтрации кодов используйте параметр запроса codes. Для настройки самого ограничения кода перейдите в раздел администратора: * Купоны ### Активация акции с купонами - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/activate-coupon.md): Активирует акцию с купонами. После создания акция с купонами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы включить и активировать акцию с купонами. ### Получение кодов купонов - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupon-codes.md): Получает коды купонов. ### Создание кода купона - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/create-coupon-code.md): Создает код купона. ### Генерация кодов купонов - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/generate-coupon-codes.md): Генерирует коды купонов. ### Деактивация акции с купонами - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/deactivate-coupon.md): Деактивирует акцию с купонами. После создания акция с купонами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы выключить и деактивировать акцию с купонами. ### Информация об ограничении на применение купонов для указанного пользователя - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupon-user-limit.md): Получает информацию об оставшемся количестве применений купона для указанного пользователя. API ограничений для пользователей позволяет ограничить доступное количество применений купона. Для настройки самого ограничения перейдите в раздел администратора: * Купоны ### Получение вознаграждений по купону - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupon-rewards-by-code.md): Получает вознаграждения по купону по его коду. Может использоваться, чтобы дать пользователям возможность выбрать один предмет из множества в качестве бонуса. Обычным случаем, если купон содержит игру в качестве бонуса (тип unit), является выбор платформы. ### Погашение кода купона - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/redeem-coupon.md): Погашает код купона. Пользователь получает бонус после погашения купона. ### Получение списка акций с купонами - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupons.md): Получает список акций с купонами в рамках проекта. ### Создание акции с купонами - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/admin-create-coupon.md): Создает акцию с купонами. ### Удаление акции с купонами - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/delete-coupon-promotion.md): Удаляет акцию с купонами. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров. Пользователь не сможет получить бонусные товары по этой акции. После удаления акция не может быть восстановлена. Коды купонов из удаленной акции могут быть добавлены в существующие акции. ### Получение акции с купонами - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/get-coupon.md): Получает указанную акцию с купонами. ### Обновление акции с купонами - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-coupons/update-coupon-promotion.md): Обновляет акцию с купонами. ## Промокоды Этот API позволяет вам управлять промокодами. ### Информация об ограничении на применение промокодов - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promo-code-code-limit.md): Возвращает оставшееся количество применений кодов. Для фильтрации кодов используйте codesпараметр запроса. Для настройки самого ограничения перейдите в раздел администратора: * Промокоды ### Активация акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/activate-promo-code.md): Активирует акцию с промокодами. После создания акция с промокодами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы включить и активировать акцию с промокодами. ### Получение кодов акции с промокодами - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promocode-codes.md): Получает коды акции с промокодами. ### Создание кода для акции с промокодами - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/create-promo-code-code.md): Создает код для акции с промокодами. ### Генерация кодов для акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/generate-promo-code-codes.md): Генерирует коды для акции с промокодами. ### Деактивация акции с промокодами - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/deactivate-promo-code.md): Деактивирует акцию с промокодами. После создания акция с промокодами по умолчанию отключена. Погашение по акции не будет доступно, пока вы ее не активируете. Используйте данный метод, чтобы выключить и деактивировать акцию с промокодами. ### Информация об ограничении на применение промокодов для указанного пользователя - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promo-code-user-limit.md): Получает информацию об оставшемся количестве применений промокода для указанного пользователя. API ограничений для пользователей позволяет ограничить доступное количество применений промокода. Для настройки самого ограничения перейдите в раздел администратора: * Промокоды ### Получение вознаграждения по промокоду - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promo-code-rewards-by-code.md): Получает вознаграждения по промокоду по его коду. Может использоваться, чтобы дать пользователям возможность выбрать один предмет из множества в качестве бонуса. Обычным случаем, если промокод содержит игру в качестве бонуса (тип unit), является выбор платформы. ### Погашение промокода - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/redeem-promo-code.md): Использует код акции с промокодами. После погашения промокода пользователь получит бесплатные товары и/или цена корзины и/или отдельных товаров будет снижена. ### Удаление промокода из корзины - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/remove-cart-promo-code.md): Удаляет промокод из корзины. После удаления промокода общая цена всех товаров в корзине будет пересчитана без учета бонусов и скидок, предоставляемых промокодом. ### Получение списка акций с промокодами - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promo-codes.md): Получает список промокодов проекта. ### Создание акции с промокодами - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/create-promo-code.md): Создает акцию с промокодами. ### Удаление акции с промокодами - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/delete-promo-code.md): Удаляет акцию с промокодами. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет получить бонусные товары или купить товары с применением этой акции. После удаления акция не может быть восстановлена. Промокоды из удаленной акции могут быть добавлены в существующие акции. ### Получение акции с промокодами - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/get-promo-code.md): Получает указанную акцию с промокодами. ### Обновление акции с промокодами - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes/update-promo-code.md): Обновляет акцию с промокодами. ## Уникальный каталог предложений Этот API позволяет вам управлять уникальными предложениями каталога. ### Активация уникального акционного предложения по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): Активирует уникальное акционное предложение по каталогу. Созданное уникальное акционное предложение каталога по умолчанию отключено. Оно не может быть погашено до тех пор, пока вы его не активируете. Используйте этот эндпоинт для включения и активации акции с купонами. ### Получение уникальных кодов предложений по каталогу - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): Получает уникальные коды предложений по каталогу. ### Создание уникального кода предложения по каталогу - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): Создает уникальный код предложения по каталогу. ### Генерация уникальных кодов предложений по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): Генерирует уникальные коды предложений по каталогу. ### Отключите уникальное акционное предложение по каталогу - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): Отключает уникальное акционное предложение по каталогу. Созданное уникальное акционное предложение по умолчанию отключено. Оно не может быть погашено, пока вы его не активируете. Используйте этот эндпоинт для отключения и деактивации акции с купонами. ### Получение списка уникальных акционных предложений каталога - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offers.md): Получает список уникальных акционных предложений каталога проекта. ### Создание уникального акционного предложения по каталогу - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): Создает уникальное акционное предложение по каталогу. ### Удаление уникального акционного предложения каталога - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): Удаляет уникальное акционное предложение каталога. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет купить товары с применением этой акции. После удаления акция не может быть восстановлена. ### Получение уникального акционного предложения по каталогу - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offer.md): Получает указанное уникальное акционное предложение по каталогу. ### Обновление уникального акционного предложения каталога - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ru/api/liveops/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): Обновляет уникальное акционное предложение каталога. ## Скидки Этот API позволяет вам управлять скидочными акциями. ### Получение списка акций со скидками - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ru/api/liveops/promotions-discounts/get-item-promotion-list.md): Получает список акций со скидками в рамках проекта. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Создание акции со скидками для товара - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ru/api/liveops/promotions-discounts/create-item-promotion.md): Создает акцию со скидками для товара. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Удаление скидочной акции - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/liveops/promotions-discounts/delete-item-promotion.md): Удаляет скидочную акцию. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет купить товары с применением этой акции. После удаления акция не может быть восстановлена. ### Получение акции со скидками - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/liveops/promotions-discounts/get-item-promotion.md): Получает акцию, применяемую к определенным товарам. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ### Обновление акции со скидками - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ru/api/liveops/promotions-discounts/update-item-promotion.md): Обновляет акцию. ПримечаниеНовые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные. Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары. ## Бонусы Этот API позволяет вам управлять бонусными акциями. ### Получение списка акций с бонусами - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ru/api/liveops/promotions-bonuses/get-bonus-promotion-list.md): Получает список акций с бонусами в рамках проекта. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Создание акции с бонусами - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ru/api/liveops/promotions-bonuses/create-bonus-promotion.md): Создает акцию с бонусами. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Удаление бонусной акции - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/liveops/promotions-bonuses/delete-bonus-promotion.md): Удаляет бонусную акцию. Удаленная акция: * Пропадет из списка акций, настроенных в вашем проекте. * Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет получить бонусные товары по этой акции. После удаления акция не может быть восстановлена. ### Получение акции с бонусами - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/liveops/promotions-bonuses/get-bonus-promotion.md): Получает акцию с бонусами. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ### Обновление акции с бонусами - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ru/api/liveops/promotions-bonuses/update-bonus-promotion.md): Обновляет акцию. ПримечаниеНовые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные. Акция добавляет бесплатные бонусные товары к покупке, совершенной пользователем. Акция может быть применена к каждой покупке в рамках проекта или к покупке, включающей определенные товары. ## Персонализированный каталог Данный API позволяет задавать правила для пользовательских атрибутов. Если пользователь соответствует всем условиям для конкретного правила, будут показаны персонализированные товары. Узнать о персонализированных акциях можно в [подразделе "Скидки"](/ru/api/shop-builder/tag/promotions-discounts) раздела "Акции". Чтобы передать атрибуты перед покупкой, вы можете использовать [API Авторизации Иксолла](/ru/api/login/operation/update-users-attributes-from-server/) или передать их в [свойство user.attributes при генерации токена с помощью API Платежей Иксолла](/ru/api/pay-station/operation/create-token). ### Получение списка правил фильтрации каталога - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/get-filter-rules.md): Получает все правила, применяемые к атрибутам пользователя. ### Создание правила фильтрации каталога - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/create-filter-rule.md): Создает правило для пользовательских атрибутов. ### Получение всех правил каталога для поиска на стороне клиента - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/get-all-filter-rules.md): Получает список всех правил каталога для поиска на стороне клиента. ВниманиеВозвращает только ID правила, имя и is_enabled ### Удаление правила фильтрации каталога - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/delete-filter-rule-by-id.md): Удаляет определенное правило. ### Получение правила фильтрации каталога - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/get-filter-rule-by-id.md): Получает конкретное правило, применяемое к атрибутам пользователя. ### Корректировка правила фильтрации каталога - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/patch-filter-rule-by-id.md): Обновляет определенное правило, применяемое к атрибутам пользователя. Для неуказанных свойств будет использоваться текущее значение. ### Обновление правила фильтрации каталога - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ru/api/liveops/personalized-catalog/update-filter-rule-by-id.md): Обновляет определенное правило, применяемое к атрибутам пользователя. Для неуказанных свойств (при их необязательности) будет использоваться значение по умолчанию. ## Управление ### Обновление лимитов акций для пользователя - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/reset-all-user-promotions-limit.md): Обновляет все лимиты по всем акциям для указанного пользователя, чтобы он мог снова использовать эти акции. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Уменьшение лимита акций для пользователя - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/remove-user-promotion-limit.md): Уменьшает оставшееся количество раз, когда указанный пользователь может воспользоваться рекламной акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Получение лимита акций для пользователя - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/get-user-promotion-limit.md): Возвращает оставшееся количество раз, когда указанный пользователь может воспользоваться акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Увеличение лимита акций для пользователя - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/add-user-promotion-limit.md): Увеличивает оставшееся количество раз, когда указанный пользователь может воспользоваться акцией в пределах установленного лимита. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Настройка лимита акций для пользователя - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/set-user-promotion-limit.md): Задает количество раз, когда указанный пользователь может воспользоваться рекламной акцией в пределах лимита, примененного после его увеличения или уменьшения. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ### Обновление лимита акций для пользователей - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/ru/api/liveops/user-limits-admin/reset-user-promotion-limit.md): Обновляет лимит акции, чтобы пользователь мог снова воспользоваться этой акцией. Если параметр user равен null, этот вызов обновляет это ограничение для всех пользователей. API лимитов пользователя позволяет ограничить количество раз, когда пользователи могут использовать рекламную акцию. Для настройки самого лимита перейдите в раздел Admin нужного типа акции: * Акции со скидками * Бонусные акции ## Admin ### Получение списка призовых баллов - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-get-value-points-list.md): Получает список призовых баллов для проекта администрирования. ### Создание призовых баллов - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-create-value-points.md): Создает призовые баллы, которые выдаются за покупку товаров в каталоге. ### Удаление призовых баллов - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-delete-value-point.md): Удаляет призовые баллы, идентифицированные по артикулу товара. ### Получение призовых баллов - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-get-value-point.md): Получает призовые баллы по артикулу для проекта администрирования. ### Обновление призовых баллов - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-update-value-point.md): Обновляет призовые баллы, идентифицированные по артикулу. ### Удаление призовых баллов с товаров - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): Удаляет призовые баллы со ВСЕХ товаров. ### Получение списка товаров с призовыми баллами - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): Получает список всех товаров с призовыми баллами для проекта администрирования. ### Частичное обновление призовых баллов для товаров - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): Частично обновляет количество призовых баллов для одного или нескольких товаров по артикулам этих товаров. Пользователи получают призовые баллы после покупки этих товаров. Принципы обновления призовых баллов: * Если у товара еще нет призовых баллов, отправка ненулевого значения в поле amount создаст их. * Если у товара уже есть призовые баллы, отправка ненулевого значения в поле amount обновит их. * Если в поле amount передано значение 0, существующие призовые баллы для этого товара будут удалены. В отличие от метода PUT (Настройка призовых баллов для товаров), этот метод PATCH не перезаписывает все ранее установленные призовые баллы для товаров в проекте, а обновляет только указанные. В одном запросе можно обновить до 100 товаров. В одном запросе нельзя передавать одинаковые артикулы товаров. ### Настройка призовых баллов для товаров - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): Присваивает призовые баллы одному или нескольким товарам по артикулу. Пользователи получают призовые баллы после покупки этих товаров. Обратите внимание, что этот запрос PUT перезаписывает все ранее установленные призовые баллы для товаров в проекте. Чтобы избежать непреднамеренного удаления призовых баллов, включайте все товары и соответствующие им значения в каждый запрос PUT. Если вы хотите обновить призовые баллы только для определенного товара, сохранив значения призовых баллов для других товаров, вам следует получить текущий набор призовых баллов с помощью запроса GET, изменить значения призовых баллов для желаемого товара, а затем отправить измененный набор призовых баллов обратно с обновленными значениями призовых баллов для конкретного товара. ### Получение списка цепочек наград - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-get-reward-chains.md): Получает список цепочек наград. Внимание! Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 10 товаров в ответе.Чтобы получить больше данных постранично, используйте поля limit и offset. ### Создание цепочек наград - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-create-reward-chain.md): Создает цепочку наград. ### Удаление цепочек наград - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-delete-reward-chain.md): Удаляет определенную цепочку наград. ### Получение цепочек наград - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-get-reward-chain.md): Получает определенную цепочку наград. ### Обновление цепочек наград - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-update-reward-chain.md): Обновляет определенную цепочку наград. ### Сброс цепочки наград - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-reset-reward-chain.md): Сбрасывает призовые баллы и прогресс всех пользователей в цепочке наград.После сброса вы можете обновить срок действия цепочки наград и пользователи смогут снова продвигаться по ней. Внимание Не следует сбрасывать цепочку наград в период ее действия. В этом случае пользователи могут потерять заработанные очки до получения награды. ### Переключение цепочки наград - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/ru/api/liveops/reward-chain-value-points-admin/admin-toggle-reward-chain.md): Включение/отключение цепочки наград. ## Клиент ### Получение цепочки наград текущего пользователя - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/ru/api/liveops/reward-chain-client/get-reward-chains-list.md): Метод клиента. Получает цепочки наград текущего пользователя. Внимание! Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров в ответе. Чтобы получить больше данных постранично, используйте поля limit и offset. ### Получение призовых баллов текущего пользователя - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/ru/api/liveops/reward-chain-client/get-user-reward-chain-balance.md): Метод клиента. Возвращает призовые баллы текущего пользователя. ### Получение награды на уровне - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/ru/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward.md): Метод клиента. Запрашивает награду на уровне для текущего пользователя в цепочке наград. ## Клиент кланов ### Получение 10 участников, внесших наибольший вклад в продвижение по клановой цепочке наград - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/ru/api/liveops/clan-reward-chain-client/get-user-clan-top-contributors.md): Возвращает 10 участников, внесших наибольший вклад в определенную цепочку наград для текущего клана пользователя. Если пользователь не состоит в клане, в ответе вернется пустой массив. ### Обновление клана текущего пользователя - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/ru/api/liveops/clan-reward-chain-client/user-clan-update.md): Обновляет текущий клан пользователя через атрибуты пользователя. Выдает пользователю награды, которые он не забрал из цепочки наград старого клана, и возвращает их в ответе. Если пользователь состоял в клане, а теперь нет — принадлежность к клану будет удалена. Если пользователь сменил клан, принадлежность к клану изменится и будет указан новый клан. ## Admin ### Получение списка ежедневных наград - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-get-daily-chains.md): Получает список ежедневных наград для администрирования. ПримечаниеМетод возвращает список элементов с учетом пагинации. Максимальное количество элементов в ответе — 50 (установлено по умолчанию). Чтобы получить доступ к следующим элементам списка, используйте параметры limit и offset. Например, при вызове метода с параметрами limit = 25 и offset = 100 вернется 25 элементов, начиная со 101-го в общем списке. ### Создание ежедневной награды - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-create-daily-chain.md): Создает ежедневную награду. ### Удаление ежедневной награды - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-delete-daily-chain.md): Удаляет определенную ежедневную награду. ### Получение ежедневной награды - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-get-daily-chain.md): Возвращает определенную ежедневную награду для администрирования. ### Обновление ежедневной награды - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-update-daily-chain.md): Обновляет определенную ежедневную награду. ### Сброс ежедневной награды - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-reset-daily-chain.md): Сбрасывает прогресс для всех пользователей в ежедневной награде. Применяется только к ежедневным наградам с типом rolling. ### Переключение ежедневной награды - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/ru/api/liveops/daily-chain-admin/admin-toggle-daily-chain.md): Включает или отключает ежедневную награду. ## Клиент ### Получение ежедневных наград для текущего пользователя - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/ru/api/liveops/daily-chain-client/get-daily-chains-list.md): Клиентский метод. Возвращает ежедневные награды для текущего пользователя. ПримечаниеМетод возвращает список элементов с учетом пагинации. Максимальное количество элементов в ответе — 50 (установлено по умолчанию). Чтобы получить доступ к следующим элементам списка, используйте параметры limit и offset. Например, при вызове метода с параметрами limit = 25 и offset = 100 вернется 25 элементов, начиная со 101-го в общем списке. ### Получение ежедневной награды по ее ID для текущего пользователя - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/ru/api/liveops/daily-chain-client/get-user-daily-chain-by-id.md): Клиентский метод. Возвращает ежедневную награду по ее ID для текущего пользователя. ### Получение ежедневной награды за уровень - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ru/api/liveops/daily-chain-client/claim-user-daily-chain-step-reward.md): Клиентский метод. Возвращает награду на текущем уровне в цепочке ежедневных наград для текущего пользователя. Все уровни могут быть пройдены только в заданном порядке. Награду за пропущенный уровень нельзя получить за виртуальную или реальную валюту, или просмотр рекламного ролика. ## Admin ### Получение списка цепочек предложений - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-get-offer-chains.md): Возвращает список цепочек предложений для администрирования. Внимание Все проекты имеют ограничение на количество элементов, возвращаемых в одном ответе. Максимальное значение — 10 элементов в ответе. Чтобы получить больше данных, используйте query-параметры limit и offset для пагинации. ### Создание цепочки предложений - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-create-offer-chain.md): Создает цепочку предложений. ### Удаление цепочки предложений - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-delete-offer-chain.md): Удаляет конкретную цепочку предложений. После удаления цепочки:Все уже полученные пользователями награды сохраняются.Непройденные уровни становятся недоступны, и получить награды за них больше нельзя. Удаление цепочки необратимо и не сохраняет прогресс пользователя, в отличие от временного отключения цепочки с помощью метода Переключение цепочки предложений. ### Получение цепочки предложений - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-get-offer-chain.md): Возвращает конкретную цепочку предложений для администрирования. ### Обновление цепочки предложений - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-update-offer-chain.md): Обновляет конкретную цепочку предложений. ### Переключение цепочки предложений - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-toggle-offer-chain.md): Включает или отключает цепочку предложений. При отключении цепочки пользователи теряют доступ к ней, но их прогресс сохраняется. После повторного включения цепочки пользователь может продолжить прохождение с того уровня, на котором остановился. ## Клиент ### Получение цепочек предложений для текущего пользователя - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/get-offer-chains-list.md): Возвращает цепочки предложений для текущего пользователя. Внимание Все проекты имеют ограничение на количество элементов, возвращаемых в одном ответе. Максимальное значение — 30 элементов на запрос. Чтобы получить больше данных, используйте параметры limit и offset для пагинации. ### Получение цепочки предложений по ее ID для текущего пользователя - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/get-user-offer-chain-by-id.md): Возвращает цепочку предложений по ее ID для текущего пользователя. ### Получение награды за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/claim-user-offer-chain-step-reward.md): Завершает прохождение текущим пользователем уровня цепочки предложений и выдает связанную с ним награду. Внимание Используйте этот метод только для бесплатных уровней. Для уровней, доступных за реальную валюту, используйте метод Создание заказа на награду за уровень цепочки предложений. ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ## payment-client-side ### Создание заказа на награду за уровень цепочки предложений - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/order-user-offer-chain-step-reward.md): Создает заказ на товар, связанный с указанным уровнем цепочки предложений. Полученный заказ получает статус new. Чтобы открыть платежный интерфейс в новом окне, используйте ссылку: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен. Для тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}. Внимание Используйте этот метод только на стороне клиента. Метод определяет страну пользователя по IP-адресу, чтобы применить соответствующую валюту и доступные способы оплаты. Вызов с сервера может привести к некорректному определению валюты и повлиять на способы оплаты в Pay Station. Внимание Используйте только для получения наград на платных уровнях цепочки предложений. Для платных используйте метод Получение награды за уровень цепочки предложений. ## Admin ### Получение информации об апселле в проекте - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin.md): Возвращает информацию об апселле в проекте: включен или выключен апселл, какой тип апселла используется, а также список товаров, используемых в апселле. ### Создание апселла - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/liveops/upsell-admin/post-upsell.md): Создает апселл в проекте. ### Обновление апселла - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ru/api/liveops/upsell-admin/put-upsell.md): Обновляет апселл в проекте. ### Активация/деактивация апселла в проекте - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/ru/api/liveops/upsell-admin/put-upsell-toggle-active-inactive.md): Меняет статус апселла в проекте: активирует или деактивирует. ## Клиент ### Получение списка товаров для апселла в проекте - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/ru/api/liveops/upsell-client/get-upsell-for-project-client.md): Получает список товаров для апселла в проекте, если они уже настроены.