Förnya en Microsoft Store-ID-nyckel
Använd den här metoden för att förnya en Microsoft Store-nyckel. När du generera en Microsoft Store-ID-nyckelär nyckeln giltig i 30 dagar. Innan nyckeln upphör att gälla kan du använda den för att omförhandla en ny nyckel med hjälp av den här metoden.
Biblioteket Microsoft.StoreServices innehåller funktionerna i den här metoden via API:et UserStoreId.RefreshStoreId.
Note
Tidigare hade Microsoft Store-nycklar en längre livslängd och kunde i vissa fall förnyas efter att nyckeln redan hade upphört att gälla. Nu bör utvecklare bara förvänta sig att nycklar kan förnyas under sin livstid och bör notera förfallodatumet för nycklarna för att förnya dem innan de upphör att gälla.
Viktig
Även om Microsoft Store-nycklar kan förnyas innan de upphör att gälla kan nycklarna återkallas innan de upphör att gälla som svar på säkerhetsproblem. Därför bör dina tjänster hantera det fall där ett förnyelseförsök misslyckas med AuthenticationTokenInvalid. I det här fallet bör du generera en ny Microsoft Store-nyckel för användaren på klienten eller den metod som används för att generera den ursprungliga Microsoft Store-nyckeln.
Förutsättningar
Om du vill använda den här metoden behöver du:
- En Entra-ID-åtkomsttoken som har audience URI-värdet
https://onestore.microsoft.com/.default. - En ID-nyckel för Microsoft Store som har upphört att gälla och som genererats från kod på klientsidan i din app.
Mer information finns i Hantera produkträttigheter från en tjänst.
Begäran
Begäranssyntax
| Nyckeltyp | Metod | Begär URI |
|---|---|---|
| Samlingar | POST | https://collections.mp.microsoft.com/v6.0/b2b/keys/renew |
| Köp | inlägg | https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew |
Begäranshuvud
| Rubrik | Typ | Beskrivning |
|---|---|---|
| Värd | sträng | Måste anges till värdet collections.mp.microsoft.com eller purchase.mp.microsoft.com. |
| Innehållslängd | nummer | Längden på begärandetexten. |
| Innehållstyp | sträng | Anger typ av begäran och svar. För närvarande är det enda värde som stöds application/json. |
Begärandetext
| Parameter | Typ | Beskrivning | Krävs |
|---|---|---|---|
| serviceTicket | sträng | Åtkomsttoken för Entra-ID. | Ja |
| nyckel | sträng | Microsoft Store-ID-nyckeln har upphört att gälla. | Ja |
Exempel på begäran
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…."
}
Svar
Svarskropp
| Parameter | Typ | Beskrivning |
|---|---|---|
| nyckel | sträng | Den uppdaterade Microsoft Store-nyckeln som kan användas i framtida anrop till API:et för Microsoft Store-samlingar eller inköps-API:et. |
Svarsexempel
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….."
}
Felkoder
| Kod | Fel | Inre felkod | Beskrivning |
|---|---|---|---|
| 401 | Obehörig | Ogiltig autentiseringstoken | Åtkomsttoken för Entra-ID eller Microsoft Store-nyckeln som förnyas är ogiltig. I vissa fall kommer detaljerna i ServiceError att innehålla mer information, till exempel när token har gått ut eller appid krav saknas. |
| 401 | Obehörig | InconsistentClientId | Det clientId- anspråket i Microsoft Store-ID-nyckeln och det appid- anspråket i Entra ID-åtkomsttoken matchar inte. |