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

# Renovar uma chave de ID de usuário da Store

> Renove uma chave de ID de usuário da Store nos serviços da Microsoft Store antes que seu tempo de vida de 30 dias expire, para que seu back-end possa continuar autenticando chamadas.

Este artigo descreve como renovar uma chave de ID de usuário da Store.

Quando você [gera uma chave de ID de usuário da Store](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key), ela tem um tempo de vida de 30 dias. Dentro desse período, a chave pode autenticar chamadas aos serviços da Microsoft Store. Você pode renová-la antes da expiração para gerar uma nova chave para a mesma ID do cliente do aplicativo do Microsoft Entra e a mesma identidade de usuário.

## Pré-requisitos

Para renovar uma chave de ID de usuário da Store, você precisa das seguintes chaves/tokens:

* Um token de acesso do Microsoft Entra ID que tenha o valor de URI de público `https://onestore.microsoft.com`
* Uma chave de ID da Microsoft Store expirada que foi [gerada a partir do código do lado do cliente no seu aplicativo](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key).

Para obter mais informações, consulte [Solicitar um ID de usuário da Store para autenticação de serviço para serviço](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid).

## Solicitação

### Sintaxe da solicitação

| Tipo de chave | Método | URI da solicitação |
| - | - | - |
| `Collections` | `POST` | `https://collections.mp.microsoft.com/v6.0/b2b/keys/renew` |
| `Purchase` | `POST` | `https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew` |

### Cabeçalho da solicitação

| Cabeçalho | Tipo | Descrição |
| - | - | - |
| `Host` | `string` | Deve ser definido com o valor `collections.mp.microsoft.com` ou `purchase.mp.microsoft.com`. |
| `Content-Length` | `number` | O comprimento do corpo da solicitação. |
| `Content-Type` | `string` | Especifica o tipo de solicitação e de resposta. Atualmente, o único valor compatível é `application/json`. |

### Corpo da solicitação

| Parâmetro | Tipo | Descrição | Obrigatório |
| - | - | - | - |
| `serviceTicket` | `string` | Token de acesso de serviço do Microsoft Entra ID. | Sim |
| `key` | `string` | Chave de ID da Microsoft Store expirada. | Sim |

### Exemplo de solicitação

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

## Resposta

### Corpo da resposta

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `key` | `string` | A chave de ID de usuário da Store atualizada que pode ser usada em chamadas futuras à API de coleções ou à API de compra da Microsoft Store |

### Exemplo de resposta

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

| Código | Erro | Código de erro interno | Descrição |
| - | - | - | - |
| 401 | Unauthorized | `AuthenticationTokenInvalid` | O token de acesso do Microsoft Entra ID é inválido. Em alguns casos, `ServiceError` inclui mais detalhes, como a expiração do token ou uma declaração `appid` ausente. |
| 401 | Unauthorized | `InconsistentClientId` | A declaração `clientId` na chave de ID de usuário da Store e a declaração `appid` no token de acesso do Microsoft Entra ID não correspondem. |

## Documentação de referência da API

* [XStore (conteúdo da API)](/pt-BR/reference/system/xstore/xstore_members)

## Confira também

[Comércio (visão geral)](/pt-BR/publishing/xstore-commerce/xstore-commerce-overview)

[Gerenciar produtos a partir dos seus serviços](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service)

[Solicitar um ID de usuário da Store para autenticação de serviço para serviço](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid)

[Solicitar um ID de usuário da Store a partir do seu serviço com X-tokens ou OAuth 2.0](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth)

[Autenticar seu serviço com as APIs da Microsoft Store](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service)

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

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

[XStore (referência da API)](/pt-BR/reference/system/xstore/xstore_members)


## Related topics

- [Notas de versão do SDK C++ do PlayFab Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Visão geral de acessibilidade no GDK](/pt-BR/build/game-principles/accessibility/accessibility-overview.md)
- [Guia de BVT de PC da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [Renovación de una clave de User Store ID](/es/publishing/xstore-commerce/xstore-renew-userstoreid.md)
- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)