# 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ção
    Todos os projetos têm uma limitação no número de itens que você pode
    obter na resposta. O valor padrão e máximo é 50 itens
    por resposta. Para obter mais dados página por página, use os campos limit
    e offset.





  Nota
    Esta chamada de API retorna dados genéricos do catálogo de itens quando usada sem
    autorização. Use a autorização para recuperar
    dados personalizados
    do usuário, como limites e promoções associadas ao item.
    Para fazer isso, passe o JWT do usuário no cabeçalho Authorization.
    Para mais informações sobre o JWT do usuário, consulte o bloco Segurança
    para esta chamada.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/.
    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.

  - `total_items_count` (integer)
    Número total de itens no sistema.

  - `items` (array)

  - `items.name` (string)
    Nome do pacote do jogo.

  - `items.description` (string)
    Descrição do pacote do jogo.

  - `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.

  - `items.game_sku` (string)
    ID de pacote de chaves exclusivo.

  - `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.image_url` (string)
    URL da imagem. Para que a imagem seja exibida corretamente e carregue rapidamente na interface de pagamento, confira as nossas diretrizes de imagens e URLs:Formatos suportados: WebP (recomendado), PNG, JPG.Tamanho do arquivo: ≤ 50 KB (para WebP) ou ≤ 150 KB (para PNG e JPG).Tamanho da imagem: 280 x 280 px.Espaço de cores: sRGB.Protocolo: HTTPS com cache de longa duração para URLs versionados.

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

  - `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`.

  - `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.

  - `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.

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

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

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