# Obtener las cadenas de recompensas del usuario actual

Punto final de cliente. Obtiene las cadenas de recompensas del usuario actual.


  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 API utiliza un JWT de usuario para la autorización.
    Incluya el token en el encabezado Authorization con el siguiente formato: Bearer <user_JWT>. Para obtener más información sobre el JWT de usuario, consulte el bloque Seguridad para esta llamada.

Endpoint: GET /v2/project/{project_id}/user/reward_chain
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).

## Response 200 fields (application/json):

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

  - `total_items_count` (integer)
    Número total de cadenas de recompensas del sistema.
    Example: 10

  - `items` (array)

  - `items.reward_chain_id` (integer)
    ID de la cadena de recompensas.
    Example: 9

  - `items.name` (string)
    Nombre de la cadena de recompensas.
    Example: "Weekly quest"

  - `items.description` (string,null)
    Descripción de la cadena de recompensas.
    Example: "Major weekly quest"

  - `items.long_description` (string,null)
    Descripción larga de la cadena de recompensas.
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.image_url` (string,null)
    URL de la imagen.

  - `items.order` (integer)
    Define el orden de disposición.

  - `items.date_start` (string)
    Fecha de inicio de su cadena de recompensas.

  - `items.date_end` (string,null)
    Fecha en la que finaliza la promoción de su cadena de recompensas. Puede ser null. Si date_end es null, la cadena de recompensas será ilimitada en el tiempo.

  - `items.clan_type` (string,null)
    Tipo de clan.
    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.top_contributors` (array)

  - `items.top_contributors.name` (string)
    El ID de usuario que se envía a Xsolla durante el proceso de autorización. El ID de usuario se utiliza para vincular al usuario con su proyecto de Xsolla Login y se muestra como un apodo. Si utiliza la autorización por [ID de usuario](https://developers.xsolla.com/es/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth), le recomendamos transmitir el parámetro name en la [respuesta del webhook](https://developers.xsolla.com/es/webhooks/operation/user-validation-in-webshop/). Este parámetro contiene el nombre de usuario que se utilizará como apodo.
    Example: "Rocket"

  - `items.top_contributors.contributed_amount` (integer)
    La cantidad de puntos de valor ganados por el usuario.
    Example: 100

  - `items.value_point` (object)

  - `items.value_point.sku` (string)
    ID único del punto de valor.

  - `items.value_point.name` (string)
    Nombre del punto de valor.

  - `items.value_point.image_url` (string)
    URL de la imagen.

  - `items.value_point.description` (string,null)
    Descripción del punto de valor.

  - `items.value_point.long_description` (string,null)
    Descripción larga del punto de valor.

  - `items.value_point.amount` (integer)
    Cantidad de puntos de valor.

  - `items.value_point.is_clan` (boolean)
    Si el punto de valor se utiliza en las cadenas de recompensas de clanes.

  - `items.steps` (array)

  - `items.steps.step_id` (integer)
    ID del paso.
    Example: 10

  - `items.steps.name` (string)
    Nombre del paso.
    Example: "Level 1"

  - `items.steps.is_claimed` (boolean)
    Si se reclama la recompensa del paso.

  - `items.steps.image_url` (string)
    URL de la imagen.

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    El número de puntos de valor que un usuario reclama para el paso.
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.

  - `items.steps.reward.name` (string)
    Nombre del artículo.
    Example: "Super box"

  - `items.steps.reward.type` (string)
    Tipo de artículo.
    Example: "bundle"

  - `items.steps.reward.description` (string)
    Descripción del artículo.
    Example: "Super box with items"

  - `items.steps.reward.image_url` (string)
    URL de la imagen.

  - `items.steps.reward.quantity` (integer)
    Cantidad del artículo.
    Example: 2

  - `items.recurrent_schedule` (object,null)
    Periodo de reinicio recurrente de la cadena de recompensas.

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    Fecha y hora estimadas en las que se restablecerá la cadena de recompensas la próxima vez (Marca de tiempo Unix).  Por ejemplo, la cadena de recompensas se reinicia mensualmente, a partir del 1 de marzo de 2024, a las 01:00 h de Kuala Lumpur (GMT+8). La fecha y hora del próximo reinicio de la cadena de recompensas, el día 1 de abril de 2024 a las 01:00 h de Kuala Lumpur (GMT+8), lo cual equivale al 31 de marzo de 2024 a las 17:00 GMT+0 o "1711904400000" en el formato Marca de tiempo Unix.  Ejemplo: "1711904400000"

  - `items.popup_header` (object,null)
    Objeto con traducciones para el encabezado de una ventana emergente con información sobre la cadena de recompensas de un clan. Código de idioma [de dos letras minúsculas](https://developers.xsolla.com/es/doc/pay-station/features/localization/).

  - `items.popup_header.en` (string,null)
    Example: "How to unlock rewards"

  - `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.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_instruction` (object,null)
    Objeto con traducciones para una ventana emergente con información sobre la cadena de recompensas de un clan. Código de idioma [de dos letras minúsculas](https://developers.xsolla.com/es/doc/pay-station/features/localization/).

  - `items.popup_instruction.en` (string,null)
    Example: "You must be a clan member to get clan rewards. You join a clan when a clan member invites you to the clan, and you accept the invite. You can also create your own clan."

  - `items.popup_instruction.ar` (string,null)

  - `items.popup_instruction.bg` (string,null)

  - `items.popup_instruction.cn` (string,null)

  - `items.popup_instruction.cs` (string,null)

  - `items.popup_instruction.de` (string,null)
    Example: "Du musst ein Clanmitglied sein, um Clananreize zu erhalten. Du trittst einem Clan bei, wenn ein Clanmitglied dich einlädt, und du die Einladung annimmst. Du kannst auch deinen eigenen Clan erstellen."

  - `items.popup_instruction.es` (string,null)
    Example: "Debes ser miembro de un clan para obtener las recompensas del clan. Te unes a un clan cuando un miembro del clan te invita al clan y aceptas la invitación. También puedes crear tu propio clan."

  - `items.popup_instruction.fr` (string,null)
    Example: "Vous devez être membre d'un clan pour obtenir les récompenses du clan. Vous rejoignez un clan lorsque qu'un membre du clan vous invite au clan et que vous acceptez l'invitation. Vous pouvez également créer votre propre clan."

  - `items.popup_instruction.he` (string,null)

  - `items.popup_instruction.it` (string,null)
    Example: "Devi essere un membro del clan per ottenere le ricompense del clan. Ti unisci a un clan quando un membro del clan ti invita al clan e accetti l'invito. Puoi anche creare il tuo clan."

  - `items.popup_instruction.ja` (string,null)
    Example: "クランリワードを受け取るには、クランメンバーでなければなりません。 クランメンバーがあなたをクランに招待し、招待を受け入れると、クランに参加できます。 あなた自身のクランを作成することもできます。"

  - `items.popup_instruction.ko` (string,null)

  - `items.popup_instruction.pl` (string,null)

  - `items.popup_instruction.pt` (string,null)

  - `items.popup_instruction.ro` (string,null)

  - `items.popup_instruction.ru` (string,null)

  - `items.popup_instruction.th` (string,null)

  - `items.popup_instruction.tr` (string,null)

  - `items.popup_instruction.tw` (string,null)

  - `items.popup_instruction.vi` (string,null)

  - `items.popup_image_url` (string,null)
    Imagen de la ventana emergente de una cadena de recompensas de clan.