# 현재 사용자의 보상 체인 가져오기

클라이언트 엔드포인트. 현재 사용자의 보상 체인을 가져옵니다.

주의모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 한계 및 오프셋 필드를 사용합니다.

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)
    클랜 보상 체인 툴팁 팝업 창의 헤더에 대한 현지화가 있는 개체입니다. 2자리 소문자 [언어 코드](https://developers.xsolla.com/ko/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)
    클랜 보상 체인 툴팁 팝업 창의 지시를 위한 현지화가 있는 개체입니다. 2자리 소문자 [언어 코드](https://developers.xsolla.com/ko/doc/pay-station/features/localization/)입니다.

  - `items.recurrent_schedule` (object,null)
    보상 체인의 반복 재설정 기간입니다.

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    다음에 보상 체인이 재설정되는 날짜와 시간의 계산 결과 (유닉스 타임 스탬프).  예를 들어 보상 체인은 2024년 3월 1일부터 쿠알라룸푸르 시간(GMT+8)을 기준으로 01:00에 매월 초기화됩니다. 다음 보상 체인 재설정 날짜 및 시간은 쿠알라룸푸르 시간(GMT+8)으로 2024년 4월 1일 01:00이며, 이는 2024년 3월 31일 17:00 GMT+0 또는 유닉스 타임 스탬프 형식으로 1711904400000에 해당합니다.  예: 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입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.
    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입니다. 사용자 ID는 사용자를 엑솔라 로그인 프로젝트와 연결하는 데 사용되며 별명으로 표시됩니다. [ 사용자 ID](https://developers.xsolla.com/ko/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth)에 따라 인증을 사용하는 경우, [ 웹훅 응답](https://developers.xsolla.com/ko/webhooks/operation/user-validation-in-webshop/)에 name 매개 변수를 전달하는 것이 좋습니다. 이 매개 변수에는 별명으로 사용될 사용자 이름이 포함되어 있습니다.
    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