Freigeben über

Verlängern eines Microsoft Store-ID-Schlüssels

  • Artikel

Verwenden Sie diese Methode, um einen Microsoft Store-Schlüssel zu verlängern. Wenn Sie einen Microsoft Store-ID-Schlüssel generieren, ist der Schlüssel 90 Tage gültig. Nachdem der Schlüssel abgelaufen ist, können Sie den abgelaufenen Schlüssel verwenden, um einen neuen Schlüssel mithilfe dieser Methode neu zu verhandeln.

Die Microsoft.StoreServices-Bibliothek stellt die Funktionalität dieser Methode über die UserStoreId.RefreshStoreId-API bereit.

Voraussetzungen

Um diese Methode zu verwenden, benötigen Sie Folgendes:

  • Ein Azure AD-Zugriffstoken mit dem Zielgruppen-URI-Wert https://onestore.microsoft.com.
  • Ein abgelaufener Microsoft Store-ID-Schlüssel, der aus clientseitigem Code in Ihrer App generiert wurde.

Weitere Informationen finden Sie unter Verwalten von Produktberechtigungen aus einem Dienst.

Anfordern

Anforderungssyntax

Typ Key Methode Anforderungs-URI
Sammlungen POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Kaufen POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Anforderungsheader

Header Typ BESCHREIBUNG
Host Zeichenfolge Muss auf den Wert collections.mp.microsoft.com oder purchase.mp.microsoft.com festgelegt werden.
Inhaltslänge Zahl Die Länge des Anforderungstexts.
Content-Type Zeichenfolge Gibt den Anforderungs- und Antworttyp an. Derzeit ist der einzige unterstützte Wert "application/json".

Anforderungstext

Parameter Typ Beschreibung Erforderlich
serviceTicket Zeichenfolge Das Azure AD-Zugriffstoken. Ja
Schlüssel Zeichenfolge Der abgelaufene Microsoft Store-ID-Schlüssel. Ja

Anforderungsbeispiel

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

Antwort

Antworttext

Parameter Typ BESCHREIBUNG
Schlüssel Zeichenfolge Der aktualisierte Microsoft Store-Schlüssel, der in zukünftigen Aufrufen der Microsoft Store-Sammlungs-API oder -Einkaufs-API verwendet werden kann.

Beispielantwort

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

Fehlercodes

Code Fehler Interner Fehlercode Beschreibung
401 Nicht autorisiert AuthenticationTokenInvalid Das Azure AD-Zugriffstoken ist ungültig. In einigen Fällen enthalten die Details des ServiceError weitere Informationen, z. B. wenn das Token abgelaufen ist oder der Appid-Anspruch fehlt.
401 Nicht autorisiert InkonsistenteClientId Der ClientId-Anspruch im Microsoft Store-ID-Schlüssel und der Appid-Anspruch im Azure AD-Zugriffstoken stimmen nicht überein.