Share via

Renovar uma chave de ID da Microsoft Store

  • Artigo

Use esse método para renovar uma chave da Microsoft Store. Quando você gera uma chave da ID da Microsoft Store, a chave é válida por 90 dias. Depois que a chave expira, você pode usar a chave expirada para renegociar uma nova chave usando esse método.

A biblioteca Microsoft.StoreServices fornece a funcionalidade desse método por meio da API UserStoreId.RefreshStoreId.

Pré-requisitos

Para usar esse método, você precisará:

Para obter mais informações, consulte Gerenciar direitos a produtos de um serviço.

Solicitação

Sintaxe da solicitação

Tipo de chave Método URI da solicitação
Coleções POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Purchase POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Cabeçalho da solicitação

parâmetro Tipo Descrição
Host string Deve ser definido como o valor collections.mp.microsoft.com ou purchase.mp.microsoft.com.
Content-Length número O tamanho do corpo da solicitação.
Tipo de conteúdo string Especifica o tipo de solicitação e resposta. Atualmente, o único valor com suporte é application/json.

Corpo da solicitação

Parâmetro Type Descrição Obrigatório
serviceTicket string O token de acesso do Azure AD. Sim
chave string A chave ID da Microsoft Store expirada. Sim

Exemplo de solicitação

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

Resposta

Corpo da resposta

Parâmetro Type Descrição
chave string A chave da Microsoft Store atualizada que pode ser usada em futuras chamadas das APIs de coleção ou compra da Microsoft Store.

Exemplo de resposta

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

Códigos do Erro

Código Erro do Código de erro interno Descrição
401 Não Autorizado AuthenticationTokenInvalid O token de acesso do Azure AD é inválido. Em alguns casos, os detalhes de ServiceError irão conter mais informações, como quando o token está expirado ou falta a declaração appid.
401 Não Autorizado InconsistentClientId A declaração clientId na chave ID da Microsoft Store e a declaração appid no token de acesso do Azure AD não correspondem.