# Obter lista de jogos de propriedade do usuário

Obtenha a lista de jogos de propriedade do usuário. A resposta conterá uma matriz de jogos de propriedade de um usuário específico.

AtençãoTodos os projetos têm uma limitação do número de itens que você pode obter na resposta. O valor padrão e máximo é de  50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset.

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

## Path parameters:

  - `project_id` (integer, required)
    ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Limite da quantidade de elementos na página.
    Example: 50

  - `offset` (integer)
    Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0).

  - `sandbox` (integer)
    Que tipo de direitos devem ser devolvidos. Se o parâmetro for definido como 1, apenas os direitos recebidos pelo usuário no modo sandbox serão retornados. Se o parâmetro não for passado ou estiver definido como 0, apenas os direitos recebidos pelo usuário no modo ativo serão retornados.

  - `additional_fields[]` (array)
    A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação. attributes de campos disponíveis.

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Usado como um indicador de que há mais páginas.
    Example: true

  - `items` (array)

  - `items.attributes` (array)
    Lista de atributos e seus valores correspondentes ao jogo.

Atenção. Essa parte da resposta estará disponível somente se você enviar o parâmetro de consulta '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 de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nome do atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valor do atributo.
    Example: "Strategy"

  - `items.description` (string)
    Descrição do pacote do jogo.
    Example: "Description of the greatest game in the world."

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

  - `items.game_sku` (string)
    ID de pacote de chaves exclusivo.
    Example: "theGreatestGameSku"

  - `items.image_url` (string)
    URL da imagem.
    Example: "https://none"

  - `items.is_pre_order` (boolean)
    Se o jogo está em status de pré-venda ou não.

  - `items.name` (string)
    Nome do pacote do jogo.
    Example: "The Greatest Game in the World"

  - `items.project_id` (integer)
    ID do projeto. Você pode encontrar esse parâmetro em sua [Conta de Distribuidor](https://publisher.xsolla.com/) ao lado do nome do projeto.
    Example: 44056

  - `total_items_count` (integer)
    Número total de itens no sistema.
    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