- Получение ежедневных наград для текущего пользователя
Shop Builder API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc.
Персонализированный каталог
Данный API позволяет задавать правила для пользовательских атрибутов. Если пользователь соответствует всем условиям для конкретного правила, будут показаны персонализированные товары.
Узнать о персонализированных акциях можно в подразделе "Скидки" раздела "Акции".
Чтобы передать атрибуты перед покупкой, вы можете использовать API Авторизации Иксолла или передать их в свойство user.attributes при генерации токена с помощью API Платежей Иксолла.
Запрос
Клиентский метод. Возвращает ежедневные награды для текущего пользователя.
Метод возвращает список элементов с учетом пагинации. Максимальное количество элементов в ответе — 50 (установлено по умолчанию). Чтобы получить доступ к следующим элементам списка, используйте параметры `limit` и `offset`. Например, при вызове метода с параметрами `limit = 25` и `offset = 100` вернется 25 элементов, начиная со 101-го в общем списке.
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/{project_id}/user/daily_chain
- https://store.xsolla.com/api/v2/project/{project_id}/user/daily_chain
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/44056/user/daily_chain?limit=50&offset=0' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'{ "has_more": false, "items": [ { … }, { … }, { … }, { … } ], "total_items_count": 3 }
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/{project_id}/user/daily_chain/{daily_chain_id}
- https://store.xsolla.com/api/v2/project/{project_id}/user/daily_chain/{daily_chain_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/44056/user/daily_chain/101 \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Ежедневные награды пользователя успешно получены.
Дата, когда начнет действовать ежедневная награда.
Перезапускается ли ежедневная награда. Если передано значение true, ежедневная награда автоматически сбрасывается в конце периода ее действия. Следующие значения для параметров start_date и end_date рассчитываются исходя из количества уровней ежедневной награды и времени старта ежедневной награды, заданном в параметре start_date.
Тип ежедневной награды, который определяет, когда пользователи могут получать награды.
| Перечисление Значение | Описание |
|---|---|
| calendar_hard | Разблокирует следующий уровень наград каждые 24 часа. Неполученные награды становятся недоступны, как только открывается награда за следующий уровень. |
| rolling_skippable | Разблокирует награду за следующий уровень каждые 24 часа, отсчет начинается со значения, указанного в параметре date_start. Прогресс последовательный: новая награда не откроется, пока не будет получена предыдущая. Если пользователь пропустил один или несколько дней, Если пользователь пропускает один или несколько дней, он продолжает с того уровня, где остановился; за пропущенные дни награды не полагаются. |
| rolling_unskippable | Разблокирует награду за следующий уровень каждые 24 часа, отсчет начинается со значения, указанного в параметре date_start. Прогресс последовательный: новая награда не откроется, пока не будет получена предыдущая. Если пользователь пропустил день, его прогресс сбрасывается и он начинает заново с первого уровня. |
Дата окончания срока действия ежедневных наград. Может быть null. При установке типа calendar_hard эта дата будет автоматически рассчитана по количеству добавленных уровней, поэтому можно оставить значение null.
{ "date_end": "2025-04-03T18:16:00+05:00", "date_start": "2025-04-01T18:16:00+05:00", "description": "Active daily reward description", "id": 101, "name": "Active daily reward", "order": 1, "steps": [ { … }, { … }, { … }, { … } ], "type": "calendar_hard" }
Запрос
Клиентский метод. Возвращает награду на текущем уровне в цепочке ежедневных наград для текущего пользователя. Все уровни могут быть пройдены только в заданном порядке. Награду за пропущенный уровень нельзя получить за виртуальную или реальную валюту, или просмотр рекламного ролика.
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim
- https://store.xsolla.com/api/v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://xsolla.redocly.app/_mock/ru/api/shop-builder/v2/project/44056/user/daily_chain/101/step/number/1/claim \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Нет содержимого