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

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

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

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

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    Example: 44056

## Query parameters:

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

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

## Response 200 fields (application/json):

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

  - `items` (array)

  - `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.date_end` (string,null)
    Дата, когда закончится действие акции с цепочкой наград. Может быть null. Если date_end равна null, то цепочка наград не будет ограничена по времени.
    Example: "2020-04-15T18:16:00+05:00"

  - `items.date_start` (string)
    Дата, когда начнет действовать ваша цепочка наград.
    Example: "2020-04-15T18:16:00+05:00"

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

  - `items.image_url` (string,null)
    URL-адрес изображения.
    Example: "https://image.example.com"

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

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

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

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

  - `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.en` (string,null)
    Example: "How to unlock rewards"

  - `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_image_url` (string,null)
    Изображение для подсказки про цепочку наград для клана во всплывающем окне.
    Example: "https://image.example.com"

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

  - `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.reward_chain_id` (integer)
    ID цепочки наград.
    Example: 9

  - `items.steps` (array)

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

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

  - `items.steps.price` (object)

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

  - `items.steps.reward` (array)

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

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

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

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

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

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

  - `items.top_contributors` (array)

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

  - `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.value_point` (object)

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

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

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

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

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

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

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