Catalog API (2.0.0)
- Версия: 2.0.0
- Серверы:
https://store.xsolla.com/api - Свяжитесь с нами по электронной почте
- Адрес для связи: https://xsolla.com/
- Требуемая версия TLS: 1.2
API каталога позволяет настраивать каталог внутриигровых товаров на стороне Xsolla и отображать каталог пользователям в вашем игровом магазине.
API позволяет вам управлять такими сущностями каталога, как:
- Виртуальные предметы — внутриигровые предметы, например оружие, скины, бустеры.
- Виртуальная валюта — виртуальные деньги, которые используются для приобретения виртуальных товаров. Пакеты виртуальной валюты — предустановленные наборы виртуальной валюты.
- Бандлы — комбинированные наборы виртуальных предметов, валюты или игровых ключей, продаваемые как единый артикул.
- Игровые ключи — ключи для игр и DLC, распространяемые через такие платформы, как Steam, или других DRM-провайдеров.
- Группы — логические группировки для организации и сортировки товаров в каталоге.
Методы API делятся на следующие группы:
Admin — методы для создания, обновления, удаления и настройки товаров и групп каталога. Для вызова требуется базовая HTTP-аутентификация с использованием учетных данных Личного кабинета. Не предназначены для построения витрин для конечных пользователей.Catalog — методы для получения товаров и построения витрин для конечных пользователей. Поддерживают опциональную аутентификацию с использованием JWT пользователя для возврата персонализированных данных, таких как пользовательские лимиты и активные промоакции.
Запрос
Получает информацию о настройках вебхуков в Store. Подробная информация о настройке вебхуков приведена в документации.
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
- https://store.xsolla.com/api/v2/project/{project_id}/admin/webhook
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/catalog/v2/project/{project_id}/admin/webhook
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://store.xsolla.com/api/v2/project/44056/admin/webhook{ "is_enabled": true, "secret": "my_secret", "url": "http://site.ru/webhook" }
Запрос
Обновляет информацию о настройках вебхуков в Store. Подробная информация о настройке вебхуков приведена в документации.
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
Информация о настройках вебхуков.
Подключено ли получение вебхуков раздела Игровые сервисы.
Для вебхуков раздела Игровые сервисы настройка, заданная в этом методе, имеет приоритет над настройкой, указанной в Личном кабинете в разделе Настройки проекта > Вебхуки.
Секретный ключ проекта для подписи вебхуков раздела Игровые сервисы.
Для вебхуков раздела Игровые сервисы ключ, заданный в этом методе, имеет приоритет над ключом, сгенерированным в Личном кабинете в разделе Настройки проекта > Вебхуки.
URL-адрес вашего сервера для получения вебхуков раздела Игровые сервисы. URL-адрес должен быть общедоступным и использовать протокол HTTPS, например https://example.com. Вы также можете ввести URL-адрес из любого инструмента для тестирования вебхуков.
Для вебхуков раздела Игровые сервисы настройка, заданная в этом методе, имеет приоритет над настройкой, указанной в Личном кабинете в разделе Настройки проекта > Вебхуки.
Версия вебхуков. В версии 2 в массиве items добавлены параметры is_free, is_bonus и is_bundle_content. В версии 1 (по умолчанию) эти параметры отсутствуют.
- https://store.xsolla.com/api/v2/project/{project_id}/admin/webhook
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/catalog/v2/project/{project_id}/admin/webhook
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
-u <username>:<password> \
https://store.xsolla.com/api/v2/project/44056/admin/webhook \
-H 'Content-Type: application/json' \
-d '{
"is_enabled": true,
"secret": "my_secret_key",
"url": "http://site.ru/webhook",
"version": 1
}'