Delen via

Een Microsoft Store-id-sleutel vernieuwen

  • Artikel

Gebruik deze methode om een Microsoft Store-sleutel te vernieuwen. Wanneer u een Microsoft Store-id-sleutel genereert, is de sleutel 30 dagen geldig. Voordat de sleutel verloopt, kunt u deze gebruiken om een nieuwe sleutel te heronderhandelen met deze methode.

De microsoft.StoreServices-bibliotheek biedt de functionaliteit van deze methode via de UserStoreId.RefreshStoreId-API.

Notitie

Voorheen hadden Microsoft Store-sleutels een langere levensduur en konden in sommige gevallen worden vernieuwd nadat de sleutel al was verlopen. Ontwikkelaars mogen nu alleen verwachten dat sleutels gedurende hun levensduur kunnen worden verlengd en moeten de vervaldatum van de sleutels noteren om ze te vernieuwen voordat ze verlopen.

Belangrijk

Hoewel Microsoft Store-sleutels kunnen worden vernieuwd voordat ze verlopen, kunnen de sleutels worden ingetrokken voordat ze verlopen als reactie op beveiligingsproblemen. Daarom moeten uw services omgaan met de situatie waarin een vernieuwingspoging mislukt met authenticationTokenInvalid. In dit geval moet u een nieuwe Microsoft Store-sleutel genereren voor de gebruiker op de client of de methode die wordt gebruikt om de oorspronkelijke Microsoft Store-sleutel te genereren.

Voorwaarden

Als u deze methode wilt gebruiken, hebt u het volgende nodig:

Zie Productrechten van een servicebeheren voor meer informatie.

Verzoek

Aanvraagsyntaxis

Sleuteltype Methode Aanvraag-URI
Verzamelingen VERZENDEN https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Kopen VERZENDEN https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Aanvraagheader

Koptekst Typ Beschrijving
Gastheer snaar Moet worden ingesteld op de waarde collections.mp.microsoft.com of purchase.mp.microsoft.com.
Lengte van inhoud nummer De lengte van de aanvraagtekst.
Inhoudstype string Hiermee geeft u het aanvraag- en antwoordtype op. Momenteel is de enige ondersteunde waarde application/json-.

Verzoekgegevens

Parameter Type Beschrijving Vereist
serviceTicket snaar Het entra-id-toegangstoken. Ja
sleutel snaar De verlopen Microsoft Store-id-sleutel. Ja

Aanvraagvoorbeeld

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

Antwoord

Hoofdtekst van antwoord

Parameter Typ Beschrijving
sleutel tekenreeks De vernieuwde Microsoft Store-sleutel die in toekomstige aanroepen naar de Api voor Microsoft Store-verzamelingen of aankoop-API kan worden gebruikt.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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….."
}

Foutcodes

Code Fout Interne foutcode Beschrijving
401 Ongeoorloofd Authenticatietoken Ongeldig Het entra-id-toegangstoken of de Microsoft Store-sleutel die wordt vernieuwd, is ongeldig. In sommige gevallen bevatten de details van de ServiceError meer informatie, zoals wanneer het token is verlopen of de appid claim ontbreekt.
401 Ongemachtigd InconsistentClientId De clientId claim in de Microsoft Store-id-sleutel en de appid claim in het Entra ID-toegangstoken komen niet overeen.