> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Renovación de una clave de User Store ID

> Renueve una clave de User Store ID en los servicios de Microsoft Store antes de que expire su período de vigencia de 30 días, para que su back-end pueda seguir autenticando llamadas.

En este artículo se describe cómo renovar una clave de User Store ID.

Cuando [genera una clave de User Store ID](/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key), esta tiene un período de vigencia de 30 días. Dentro de ese período, la clave puede autenticar llamadas a los servicios de Microsoft Store. Puede renovarla antes de que expire para generar una nueva clave para el mismo identificador de cliente de aplicación de Microsoft Entra y la misma identidad de usuario.

## Requisitos previos

Para renovar una clave de User Store ID, necesita las siguientes claves o tokens:

* Un token de acceso de Microsoft Entra ID que tenga el valor de URI de audiencia `https://onestore.microsoft.com`
* Una clave de Microsoft Store ID expirada que se haya [generado desde el código del lado cliente de su aplicación](/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key).

Para obtener más información, consulte [Solicitud de un User Store ID para la autenticación de servicio a servicio](/publishing/xstore-commerce/xstore-requesting-userstoreid).

## Solicitud

### Sintaxis de la solicitud

| Tipo de clave | Método | URI de solicitud                                           |
| ------------- | ------ | ---------------------------------------------------------- |
| `Collections` | `POST` | `https://collections.mp.microsoft.com/v6.0/b2b/keys/renew` |
| `Purchase`    | `POST` | `https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew`    |

### Encabezado de solicitud

| Encabezado       | Tipo     | Descripción                                                                                              |
| ---------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `Host`           | `string` | Debe establecerse en el valor `collections.mp.microsoft.com` o `purchase.mp.microsoft.com`.              |
| `Content-Length` | `number` | La longitud del cuerpo de la solicitud.                                                                  |
| `Content-Type`   | `string` | Especifica el tipo de solicitud y respuesta. Actualmente, el único valor admitido es `application/json`. |

### Cuerpo de la solicitud

| Parámetro       | Tipo     | Descripción                                        | Obligatorio |
| --------------- | -------- | -------------------------------------------------- | ----------- |
| `serviceTicket` | `string` | Token de acceso de servicio de Microsoft Entra ID. | Sí          |
| `key`           | `string` | Clave de Microsoft Store ID expirada.              | Sí          |

### Ejemplo de solicitud

```syntax theme={null}
POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com

{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb...",
    "Key": "eyJ0eXAiOiJKV1QiLCJhbG..."
}
```

## Respuesta

### Cuerpo de la respuesta

| Parámetro | Tipo     | Descripción                                                                                                                                 |
| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `key`     | `string` | La clave de User Store ID actualizada que se puede usar en futuras llamadas a la API de colecciones o a la API de compra de Microsoft Store |

### Ejemplo de respuesta

```syntax theme={null}
HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2019 07:31:12 GMT

{
    "key":"eyJ0eXAi..."
}
```

## Códigos de error

| Código | Error        | Código de error interno      | Descripción                                                                                                                                                                           |
| ------ | ------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401    | Unauthorized | `AuthenticationTokenInvalid` | El token de acceso de Microsoft Entra ID no es válido. En algunos casos, `ServiceError` incluye más detalles, como la expiración del token o la ausencia de una notificación `appid`. |
| 401    | Unauthorized | `InconsistentClientId`       | La notificación `clientId` de la clave de User Store ID y la notificación `appid` del token de acceso de Microsoft Entra ID no coinciden.                                             |

## Documentación de referencia de la API

* [XStore (contenido de la API)](/reference/system/xstore/xstore_members)

## Consulte también

[Comercio (información general)](/publishing/xstore-commerce/xstore-commerce-overview)

[Administración de productos desde sus servicios](/publishing/xstore-commerce/xstore-authenticating-service)

[Solicitud de un User Store ID para la autenticación de servicio a servicio](/publishing/xstore-commerce/xstore-requesting-userstoreid)

[Solicitud de un User Store ID desde su servicio con tokens X u OAuth 2.0](/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth)

[Autenticación de su servicio con las API de Microsoft Store](/publishing/xstore-commerce/xstore-authenticating-service)

[Biblioteca Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services)

[Ejemplo de Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services-Sample)

[XStore (referencia de la API)](/reference/system/xstore/xstore_members)


## Related topics

- [Autenticación de su servicio con las API de Microsoft Store](/es/publishing/xstore-commerce/xstore-authenticating-service.md)
- [Solicitud de un User Store ID con tokens X u OAuth 2.0](/es/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [API b2bLicensePreview de Collections v8 de Microsoft Store](/es/reference/microsoft-store-apis/xstore-v8-query-for-products.md)
- [Solicitud de un identificador de la Tienda del usuario para la autenticación de servicio a servicio](/es/publishing/xstore-commerce/xstore-requesting-userstoreid.md)
- [collections.mp.microsoft.com/v8.0/collections/consume](/es/reference/microsoft-store-apis/xstore-v8-consume.md)