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

Метод клиента. Получает цепочки наград текущего пользователя.


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





  Примечание
    Этот метод использует JWT пользователя для авторизации.
    Передайте токен в заголовке Authorization в формате: Bearer <user_JWT>. Подробная информация о JWT пользователя приведена в блоке Безопасность для этого метода.

Endpoint: GET /v2/project/{project_id}/user/reward_chain
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта, а также в адресной строке браузера при работе с проектом. URL-адрес имеет следующий формат: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Лимит количества элементов на странице.
    Example: 50

  - `offset` (integer)
    Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Используется как индикатор того, что остались еще страницы.
    Example: true

  - `total_items_count` (integer)
    Общее количество цепочек наград в системе.
    Example: 10

  - `items` (array)

  - `items.reward_chain_id` (integer)
    ID цепочки наград.
    Example: 9

  - `items.name` (string)
    Название цепочки наград.
    Example: "Weekly quest"

  - `items.description` (string,null)
    Описание цепочки наград.
    Example: "Major weekly quest"

  - `items.long_description` (string,null)
    Развернутое описание цепочки наград.
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.image_url` (string,null)
    URL-адрес изображения.

  - `items.order` (integer)
    Определяет порядок расположения.

  - `items.date_start` (string)
    Дата, когда начнет действовать ваша цепочка наград.

  - `items.date_end` (string,null)
    Дата, когда закончится действие акции с цепочкой наград. Может быть null. Если date_end равна null, то цепочка наград не будет ограничена по времени.

  - `items.clan_type` (string,null)
    Тип клана.
    Enum: "clan", "guild", "faction", "community", "team", "squad", "alliance", "association", "coalition", "union", "group", "civilizations", "dynasty", "order", "league", "brotherhood", "kingdom", "organization", "house", "empire", "tribe", "cartel", null

  - `items.top_contributors` (array)

  - `items.top_contributors.name` (string)
    ID пользователя, который отправляется в Xsolla в процессе авторизации, связывает пользователя с вашим проектом Xsolla Login и отображается в качестве никнейма. Если вы используете [авторизацию по ID пользователя](https://developers.xsolla.com/ru/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth), мы рекомендуем передать параметр name  [в ответе на вебхук](https://developers.xsolla.com/ru/webhooks/operation/user-validation-in-webshop/). Этот параметр содержит имя пользователя, которое будет использоваться как никнейм.
    Example: "Rocket"

  - `items.top_contributors.contributed_amount` (integer)
    Количество призовых баллов, которые заработал пользователь.
    Example: 100

  - `items.value_point` (object)

  - `items.value_point.sku` (string)
    Уникальный ID призовых баллов.

  - `items.value_point.name` (string)
    Название призовых баллов.

  - `items.value_point.image_url` (string)
    URL-адрес изображения.

  - `items.value_point.description` (string,null)
    Описание призовых баллов.

  - `items.value_point.long_description` (string,null)
    Развернутое описание призовых баллов.

  - `items.value_point.amount` (integer)
    Количество призовых баллов.

  - `items.value_point.is_clan` (boolean)
    Может ли призовой балл использоваться в цепочках наград для клана.

  - `items.steps` (array)

  - `items.steps.step_id` (integer)
    ID уровня.
    Example: 10

  - `items.steps.name` (string)
    Название уровня.
    Example: "Level 1"

  - `items.steps.is_claimed` (boolean)
    Получена ли награда за уровень.

  - `items.steps.image_url` (string)
    URL-адрес изображения.

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    Количество призовых баллов, которое пользователь получит за прохождение уровня.
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.sku` (string)
    Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания.

  - `items.steps.reward.name` (string)
    Название товара.
    Example: "Super box"

  - `items.steps.reward.type` (string)
    Тип товара.
    Example: "bundle"

  - `items.steps.reward.description` (string)
    Описание товара.
    Example: "Super box with items"

  - `items.steps.reward.image_url` (string)
    URL-адрес изображения.

  - `items.steps.reward.quantity` (integer)
    Количество товаров.
    Example: 2

  - `items.recurrent_schedule` (object,null)
    Период регулярного сброса цепочки наград.

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    Расчетные дата и время, когда цепочка наград будет сброшена в следующий раз (Unix Timestamp).Например, сброс цепочки наград осуществляется ежемесячно, начиная с 1 марта 2024 в 01:00 по часовому поясу Куала-Лумпура (GMT+8). Дата и время следующего сброса цепочки наград: 1 апреля 2024 в 01:00 по часовому поясу Куала-Лумпура (GMT+8), что соответствует 31 марта 2024 17:00 GMT+0 или 1711904400000 в формате Unix Timestamp.Example: 1711904400000

  - `items.popup_header` (object,null)
    Объект с локализациями для описания всплывающей подсказки в цепочке наград для клана. Двухбуквенный [код языка в нижнем регистре](https://developers.xsolla.com/ru/doc/pay-station/features/localization/).

  - `items.popup_header.en` (string,null)
    Example: "How to unlock rewards"

  - `items.popup_header.ar` (string,null)

  - `items.popup_header.bg` (string,null)

  - `items.popup_header.cn` (string,null)

  - `items.popup_header.cs` (string,null)

  - `items.popup_header.de` (string,null)
    Example: "Wie man Belohnungen freischaltet"

  - `items.popup_header.es` (string,null)
    Example: "Cómo desbloquear recompensas"

  - `items.popup_header.fr` (string,null)
    Example: "Comment débloquer des récompenses"

  - `items.popup_header.he` (string,null)

  - `items.popup_header.it` (string,null)
    Example: "Come sbloccare ricompense"

  - `items.popup_header.ja` (string,null)
    Example: "報酬をアンロックする方法"

  - `items.popup_header.ko` (string,null)

  - `items.popup_header.pl` (string,null)

  - `items.popup_header.pt` (string,null)

  - `items.popup_header.ro` (string,null)

  - `items.popup_header.ru` (string,null)

  - `items.popup_header.th` (string,null)

  - `items.popup_header.tr` (string,null)

  - `items.popup_header.tw` (string,null)

  - `items.popup_header.vi` (string,null)

  - `items.popup_instruction` (object,null)
    Объект с локализациями для описания всплывающей подсказки в цепочке наград для клана. Двухбуквенный [код языка в нижнем регистре](https://developers.xsolla.com/ru/doc/pay-station/features/localization/).

  - `items.popup_instruction.en` (string,null)
    Example: "You must be a clan member to get clan rewards. You join a clan when a clan member invites you to the clan, and you accept the invite. You can also create your own clan."

  - `items.popup_instruction.ar` (string,null)

  - `items.popup_instruction.bg` (string,null)

  - `items.popup_instruction.cn` (string,null)

  - `items.popup_instruction.cs` (string,null)

  - `items.popup_instruction.de` (string,null)
    Example: "Du musst ein Clanmitglied sein, um Clananreize zu erhalten. Du trittst einem Clan bei, wenn ein Clanmitglied dich einlädt, und du die Einladung annimmst. Du kannst auch deinen eigenen Clan erstellen."

  - `items.popup_instruction.es` (string,null)
    Example: "Debes ser miembro de un clan para obtener las recompensas del clan. Te unes a un clan cuando un miembro del clan te invita al clan y aceptas la invitación. También puedes crear tu propio clan."

  - `items.popup_instruction.fr` (string,null)
    Example: "Vous devez être membre d'un clan pour obtenir les récompenses du clan. Vous rejoignez un clan lorsque qu'un membre du clan vous invite au clan et que vous acceptez l'invitation. Vous pouvez également créer votre propre clan."

  - `items.popup_instruction.he` (string,null)

  - `items.popup_instruction.it` (string,null)
    Example: "Devi essere un membro del clan per ottenere le ricompense del clan. Ti unisci a un clan quando un membro del clan ti invita al clan e accetti l'invito. Puoi anche creare il tuo clan."

  - `items.popup_instruction.ja` (string,null)
    Example: "クランリワードを受け取るには、クランメンバーでなければなりません。 クランメンバーがあなたをクランに招待し、招待を受け入れると、クランに参加できます。 あなた自身のクランを作成することもできます。"

  - `items.popup_instruction.ko` (string,null)

  - `items.popup_instruction.pl` (string,null)

  - `items.popup_instruction.pt` (string,null)

  - `items.popup_instruction.ro` (string,null)

  - `items.popup_instruction.ru` (string,null)

  - `items.popup_instruction.th` (string,null)

  - `items.popup_instruction.tr` (string,null)

  - `items.popup_instruction.tw` (string,null)

  - `items.popup_instruction.vi` (string,null)

  - `items.popup_image_url` (string,null)
    Изображение для подсказки про цепочку наград для клана во всплывающем окне.