# Obtener la lista de juegos propiedad del usuario

Obtiene la lista de juegos propiedad del usuario. La respuesta contendrá una matriz de juegos propiedad de un usuario concreto.


  Atención:
    Todos los proyectos tienen una limitación en el número de artículos que puede
    obtener en la respuesta. El valor predeterminado y máximo es de 50 artículos
    por cada respuesta. Para obtener más datos página por página, utilice los campos limit
    y offset.





  Nota:
    Esta llamada de API devuelve datos genéricos del catálogo de artículos cuando se utiliza sin
    autorización. Usa la autorización para recuperar
    datos personalizados
    del usuario, como límites y promociones asociadas con el artículo.
    Para hacer esto, transmita el JWT del usuario en el encabezado Authorization.
    Para obtener más información sobre el JWT del usuario, consulte el bloque Security
    para esta llamada.

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

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

  - `sandbox` (integer)
    Qué tipo de asignación de derechos deben devolverse. Si el parámetro se establece en 1, solo se devolverán los derechos recibidos por el usuario en el modo aislador de proceso (sandbox). Si el parámetro no se transmite o se establece en 0, solo se devolverán los derechos recibidos por el usuario en el modo real.

  - `additional_fields[]` (array)
    Lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud. attributes de campos disponibles.

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Se utiliza como indicador de que hay más páginas.

  - `total_items_count` (integer)
    Número total de artículos en el sistema.

  - `items` (array)

  - `items.name` (string)
    Nombre del paquete del juego.

  - `items.description` (string)
    Descripción del paquete de juegos.

  - `items.project_id` (integer)
    ID del proyecto. Encontrará este parámetro en su [Cuenta del editor](https://publisher.xsolla.com/) junto al nombre del proyecto.

  - `items.game_sku` (string)
    ID único del paquete de claves.

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

  - `items.image_url` (string)
    URL de la imagen. Para que la imagen se visualice correctamente y se cargue con rapidez en la interfaz de pago, consulte nuestras directrices sobre imágenes y URL:Formatos compatibles: WebP (recomendado), PNG y JPG.Tamaño del archivo: ≤ 50 KB (para WebP) o ≤ 150 KB (para PNG y JPG).Tamaño de la imagen: 280 x 280 píxeles.Espacio de color: sRGB.Protocolo: HTTPS con almacenamiento en caché de larga duración para las URL versionadas.

  - `items.is_pre_order` (boolean)
    Si el juego está o no en estado de pedido por anticipado.

  - `items.attributes` (array)
    Lista de atributos y sus valores correspondientes al juego.

Atención. Esta parte de la respuesta solo está disponible si envía el parámetro de consulta additional_fields[]=attributes.

  - `items.attributes.external_id` (string)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.

  - `items.attributes.name` (string)
    Nombre del atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.

  - `items.attributes.values.value` (string)
    Valor del 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"