Condividi tramite

Rinnovare una chiave ID di Microsoft Store

  • Articolo

Utilizza questo metodo per rinnovare una chiave di Microsoft Store. Quando generi una Microsoft Store ID key, questa ha una validità di 90 giorni. Dopo la scadenza della chiave, è possibile utilizzarla per rinegoziare una nuova chiave utilizzando questo metodo.

La libreria Microsoft.StoreServices fornisce la funzionalità di questo metodo tramite l'API UserStoreId.RefreshStoreId.

Prerequisiti

Per utilizzare questo metodo, avrai bisogno di:

  • Un token di accesso di Azure AD con il valore dell'URI del destinatario https://onestore.microsoft.com.
  • Una chiave ID di Microsoft Store scaduta generata dal codice lato client nella tua app.

Per maggiori informazioni, vedere Gestire i diritti del prodotto da un servizio.

Richiedi

Sintassi della richiesta

Tipo di chiave metodo URI della richiesta
Raccolte POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Acquisto POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Intestazione della richiesta

Intestazione Type Descrizione
Host string Deve essere impostato il valore di collections.mp.microsoft.com.
Content-Length number Lunghezza del corpo della richiesta.
Content-Type string Specifica il tipo di richiesta e risposta. Attualmente, l'unico valore supportato è application/json.

Testo della richiesta

Parametro Tipo Descrizione Richiesto
serviceTicket string Il token di accesso di Azure AD. Sì
chiave string La chiave ID di Microsoft Store scaduta. Sì

Esempio di richiesta

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

Corpo della risposta

Parametro Tipo Descrizione
chiave string La chiave aggiornata di Microsoft Store che potrà essere utilizzata in futuro chiama l'API delle raccolte di Microsoft Store o l'API di acquisto.

Risposta di esempio

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

Codici di errore

Codice Error Codice di errore interno Descrizione
401 Non autorizzata AuthenticationTokenInvalid Il token di accesso di Azure AD non è valido. In alcuni casi i dettagli del ServiceError conterranno più informazioni, ad esempio quando il token è scaduto o manca l'attestazione appid.
401 Non autorizzata InconsistentClientId L'attestazioneclientId nella Microsoft Store ID key e l'attestazioneappid nel token di accesso di Azure AD non corrispondono.