Partager via

Renouveler une clé d’ID du Microsoft Store

  • Article

Utilisez cette méthode pour renouveler une clé du Microsoft Store. Lorsque vous générez une clé d’ID du Microsoft Store, la clé est valide pendant 90 jours. Une fois la clé expirée, vous pouvez utiliser la clé expirée pour renégocier une nouvelle clé à l’aide de cette méthode.

La bibliothèque Microsoft.StoreServices fournit les fonctionnalités de cette méthode via l’API UserStoreId.RefreshStoreId.

Prérequis

Pour utiliser cette méthode, vous aurez besoin des éléments suivants :

Pour plus d’informations, consultez Gérer les droits de produit à partir d’un service.

Requête

Syntaxe de la requête

Type de clé Méthode URI de demande
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 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.
Longueur-contenu nombre Longueur du corps de la demande.
Content-Type string Spécifie le type de demande et de réponse. Actuellement, la seule valeur prise en charge est application/json.

Corps de la demande

Paramètre Type Description Obligatoire
serviceTicket string Jeton d’accès Azure AD. Oui
key string Clé d’ID du Microsoft Store expirée. Oui

Exemple de requête

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

Response

Corps de réponse

Paramètre Type Description
key string Clé du Microsoft Store actualisée qui peut être utilisée dans les appels futurs à l’API collections du Microsoft Store ou à l’API d’achat.

Exemple de réponse

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: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT

{
    "key":"eyJ0eXAi….."
}

Codes d’erreur

Code Error Code d’erreur interne Description
401 Non autorisé AuthenticationTokenInvalid Le jeton d’accès Azure AD n’est pas valide. Dans certains cas, les détails de ServiceError contiennent plus d’informations, par exemple lorsque le jeton a expiré ou que la revendication appid est manquante.
401 Non autorisé InconsistentClientId La revendication clientId dans la clé d’ID du Microsoft Store et la revendication appid dans le jeton d’accès Azure AD ne correspondent pas.