# 사용자가 소유한 게임 목록 가져오기

사용자가 소유한 게임 목록을 가져옵니다. 응답에 특정 사용자가 소유한 게임 배열이 포함됩니다.

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

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

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    페이지 요소 개수 제한입니다.
    Example: 50

  - `offset` (integer)
    목록이 생성된 요소의 개수입니다(개수는 0부터 시작함).

  - `sandbox` (integer)
    반환해야 하는 자격 유형입니다. 매개 변수를 1로 설정하면 사용자가 샌드박스 모드에서 받은 권한만 반환됩니다. 매개 변수가 전달되지 않거나 0으로 설정된 경우 사용자가 라이브 모드에서 받은 권한만 반환됩니다.

  - `additional_fields[]` (array)
    추가 필드 목록입니다. 이러한 필드는 요청에서 보내는 경우 응답에 포함됩니다. 사용할 수 있는 필드는 attributes입니다.

## Response 200 fields (application/json):

  - `has_more` (boolean)
    페이지가 더 있다는 표시로 사용됩니다.
    Example: true

  - `items` (array)

  - `items.attributes` (array)
    게임에 해당하는 특성과 값의 목록입니다.

주의. 응답의 이 부분은 additional_fields[]=attributes 쿼리 매개 변수를 보내는 경우에만 사용할 수 있습니다.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `items.attributes.external_id` (string)
    고유 특성 ID입니다. external_id는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    특성의 이름입니다.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    특성의 고유한 값 ID입니다. external_id에는 소문자 라틴어 영숫자, 대시, 밑줄만 사용할 수 있습니다.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    특성의 값입니다.
    Example: "Strategy"

  - `items.description` (string)
    게임 패키지 설명입니다.
    Example: "Description of the greatest game in the world."

  - `items.drm` (string)
    고유 DRM ID입니다.
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `items.game_sku` (string)
    고유 키 패키지 ID입니다.
    Example: "theGreatestGameSku"

  - `items.image_url` (string)
    이미지 URL입니다.
    Example: "https://none"

  - `items.is_pre_order` (boolean)
    게임이 사전 판매 상태인지 여부입니다.

  - `items.name` (string)
    게임 패키지 이름입니다.
    Example: "The Greatest Game in the World"

  - `items.project_id` (integer)
    프로젝트 ID입니다. 이 매개 변수는 [관리자 페이지](https://publisher.xsolla.com/)의 프로젝트 이름 옆에서 확인할 수 있습니다.
    Example: 44056

  - `total_items_count` (integer)
    시스템에 있는 아이템의 총 수량입니다.
    Example: 10

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401