Sdílet prostřednictvím

Prodloužení platnosti klíče ID Microsoft Storu

  • Článek

Tuto metodu použijte k obnovení klíče Microsoft Storu. Když vygenerujete klíč ID obchodu Microsoft Store, je jeho platnost 30 dnů. Než vyprší platnost klíče, můžete ho použít k opětovnému vyjednávání nového klíče pomocí této metody.

Knihovna Microsoft.StoreServices poskytuje funkcionalitu této metody prostřednictvím rozhraní API UserStoreId.RefreshStoreId.

Poznámka

Klíče z Microsoft Storu dříve měly delší životnost a v některých případech se daly obnovit po vypršení platnosti klíče. Vývojáři by teď měli očekávat, že klíče budou obnovitelné jenom během jejich životnosti a měli by si uvědomit datum vypršení platnosti klíčů, aby je mohli prodloužit před vypršením jejich platnosti.

Důležitý

Klíče z Microsoft Storu se sice dají prodloužit před vypršením jejich platnosti, ale klíče se můžou odvolat před vypršením jejich platnosti v reakci na obavy ohledně zabezpečení. Proto by vaše služby měly zpracovávat případ, kdy pokus o obnovení selže s AuthenticationTokenInvalid. V tomto případě byste měli vygenerovat nový klíč Microsoft Store pro uživatele v klientovi nebo metodu použitou k vygenerování původního klíče Microsoft Store.

Požadavky

Pokud chcete použít tuto metodu, budete potřebovat:

  • Přístupový token Entra ID, který má hodnotu identifikátoru URI cílové skupiny https://onestore.microsoft.com/.default.
  • Vypršela platnost klíče ID Microsoft Storu, který byl v aplikaci vygenerován z kódu na straně klienta.

Další informace najdete v tématu Správa nároků na produkt ze služby.

Prosba

Syntaxe požadavku

Typ klíče Metoda Request URI
Sbírky Příspěvek https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Nákup POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Hlavička požadavku

Záhlaví Typ Popis
Hostitel řetězec Musí být nastavena na hodnotu collections.mp.microsoft.com nebo purchase.mp.microsoft.com.
Délka obsahu číslo Délka textu požadavku.
Typ obsahu řetězec Určuje typ požadavku a odpovědi. V současné době je jediná podporovaná hodnota application/json .

Text požadavku

Parametr Typ Popis Požadovaný
servisní tiket řetězec Přístupový token Entra ID. Ano
klíč řetězec Vypršela platnost klíče ID Microsoft Storu. Ano

Příklad požadavku

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

Odpověď

Tělo odpovědi

Parametr Typ Popis
klíč řetězec Obnovovaný klíč Microsoft Storu, který se dá použít v budoucích voláních rozhraní API kolekcí Microsoft Storu nebo rozhraní API pro nákup.

Příklad odpovědi

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

Kódy chyb

Kód Chyba Vnitřní kód chyby Popis
401 Neautorizovaný NeplatnýAutentizačníToken Přístupový token Entra ID nebo obnovovací klíč microsoft storu jsou neplatné. V některých případech budou podrobnosti o chybě služby obsahovat více informací, například když vypršela platnost tokenu nebo chybí požadavek appid.
401 Neautorizovaný InconsistentClientId Deklarace klientId v klíči ID Microsoft Store a deklarace appid v přístupovém tokenu Entra ID se neshodují.