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

# Renouveler une clé User Store ID

> Renouvelez une clé User Store ID dans les services du Microsoft Store avant l'expiration de sa durée de vie de 30 jours, afin que votre service principal puisse continuer à authentifier les appels.

Cet article explique comment renouveler une clé User Store ID.

Lorsque vous [générez une clé User Store ID](/fr-CA/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key), sa durée de vie est de 30 jours. Pendant cette période, la clé peut authentifier les appels aux services du Microsoft Store. Vous pouvez la renouveler avant son expiration pour générer une nouvelle clé pour le même ID client d'application Microsoft Entra et la même identité d'utilisateur.

## Prérequis

Pour renouveler une clé User Store ID, vous avez besoin des clés et jetons suivants :

* Un jeton d'accès Microsoft Entra ID dont la valeur d'URI d'audience est `https://onestore.microsoft.com`
* Une clé Microsoft Store ID expirée qui a été [générée à partir du code côté client de votre application](/fr-CA/publishing/xstore-commerce/xstore-requesting-userstoreid#step-4-create-a-user-store-id-key).

Pour plus d'information, consultez [Demander un User Store ID pour l'authentification de service à service](/fr-CA/publishing/xstore-commerce/xstore-requesting-userstoreid).

## Requête

### Syntaxe de la requête

| Type de clé | Méthode | URI de la requête |
| - | - | - |
| `Collections` | `POST` | `https://collections.mp.microsoft.com/v6.0/b2b/keys/renew` |
| `Purchase` | `POST` | `https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew` |

### En-tête de la requête

| En-tête | Type | Description |
| - | - | - |
| `Host` | `string` | Doit être défini sur la valeur `collections.mp.microsoft.com` ou `purchase.mp.microsoft.com`. |
| `Content-Length` | `number` | La longueur du corps de la requête. |
| `Content-Type` | `string` | Indique le type de requête et de réponse. Actuellement, la seule valeur prise en charge est `application/json`. |

### Corps de la requête

| Paramètre | Type | Description | Obligatoire |
| - | - | - | - |
| `serviceTicket` | `string` | Jeton d'accès au service Microsoft Entra ID. | Oui |
| `key` | `string` | Clé Microsoft Store ID expirée. | Oui |

### Exemple de requête

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

## Réponse

### Corps de la réponse

| Paramètre | Type | Description |
| - | - | - |
| `key` | `string` | La clé User Store ID actualisée, qui peut être utilisée dans les appels ultérieurs à l'API collections ou à l'API purchase du Microsoft Store |

### Exemple de réponse

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

## Codes d'erreur

| Code | Erreur | Code d'erreur interne | Description |
| - | - | - | - |
| 401 | Unauthorized | `AuthenticationTokenInvalid` | Le jeton d'accès Microsoft Entra ID n'est pas valide. Dans certains cas, `ServiceError` inclut plus de détails, comme l'expiration du jeton ou une revendication `appid` manquante. |
| 401 | Unauthorized | `InconsistentClientId` | La revendication `clientId` de la clé User Store ID et la revendication `appid` du jeton d'accès Microsoft Entra ID ne correspondent pas. |

## Documentation de référence des API

* [XStore (contenu de l'API)](/fr-CA/reference/system/xstore/xstore_members)

## Voir aussi

[Commerce (vue d'ensemble)](/fr-CA/publishing/xstore-commerce/xstore-commerce-overview)

[Gérer les produits à partir de vos services](/fr-CA/publishing/xstore-commerce/xstore-authenticating-service)

[Demander un User Store ID pour l'authentification de service à service](/fr-CA/publishing/xstore-commerce/xstore-requesting-userstoreid)

[Demander un User Store ID à partir de votre service avec des jetons X ou OAuth 2.0](/fr-CA/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth)

[Authentifier votre service auprès des API du Microsoft Store](/fr-CA/publishing/xstore-commerce/xstore-authenticating-service)

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

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

[XStore (référence de l'API)](/fr-CA/reference/system/xstore/xstore_members)


## Related topics

- [Documentation de développement de jeux XBOX](/fr/index.md)
- [Renewing a User Store ID key](/publishing/xstore-commerce/xstore-renew-userstoreid.md)
- [User Store ID 키 갱신](/ko/publishing/xstore-commerce/xstore-renew-userstoreid.md)
- [续订 User Store ID 密钥](/zh-CN/publishing/xstore-commerce/xstore-renew-userstoreid.md)
- [XblMultiplayerClearActivityAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerclearactivityasync.md)