Compartir a través de

Renovación de una clave de identificador de Microsoft Store

  • Artículo

Usa este método para renovar una clave de Microsoft Store. Cuando generas una clave de ID de Microsoft Store, la clave es válida durante 30 días. Antes de que expire la clave, puede usarla para renegociar una nueva clave mediante este método.

La biblioteca Microsoft.StoreServices proporciona la funcionalidad de este método a través de la API UserStoreId.RefreshStoreId.

Nota

Anteriormente, las claves de Microsoft Store tenían una duración más larga y, en algunos casos, podían renovarse después de que la clave ya hubiera expirado. Ahora, los desarrolladores solo deben esperar que las claves sean renovables durante su vigencia y deben tener en cuenta la fecha de expiración de las claves para renovarlas antes de que expiren.

Importante

Aunque las claves de Microsoft Store se pueden renovar antes de que expiren, las claves se pueden revocar antes de sus fechas de expiración en respuesta a los problemas de seguridad. Por lo tanto, sus servicios deben controlar el caso en el que falla un intento de renovación con el AuthenticationTokenInvalid. En este caso, debes generar una nueva clave de Microsoft Store para el usuario en el cliente o el método usado para generar la clave original de Microsoft Store.

Prerrequisitos

Para usar este método, necesitará:

Para obtener más información, consulte la sección Gestión de derechos de producto desde un servicio.

Solicitar

Sintaxis de solicitud

Tipo de clave Método URI de solicitud
Colecciones PUBLICAR https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Compra PUBLICAR https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Encabezado de solicitud

Encabezado Tipo Descripción
Anfitrión string Debe establecerse en el valor collections.mp.microsoft.com o purchase.mp.microsoft.com.
Longitud del contenido number Longitud del cuerpo de la solicitud.
Tipo de contenido string Especifica el tipo de solicitud y respuesta. Actualmente, el único valor admitido es application/json.

Cuerpo de la solicitud

Parámetro Tipo Descripción Obligatorio
serviceTicket string Token de acceso de Entra ID. Sí
key string Clave de ID de Microsoft Store expirada. Sí

Ejemplo de solicitud

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

Respuesta

Cuerpo de la respuesta

Parámetro Tipo Descripción
clave string La clave actualizada de Microsoft Store que se puede usar en futuras llamadas a la API de colecciones de Microsoft Store o a la API de compra.

Ejemplo de respuesta

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

Códigos de error

Código Error Código de error interno Descripción
401 Desautorizado AuthenticationTokenInvalid El token de acceso de Entra ID o la clave de Microsoft Store que se está renuevando no son válidos. En algunos casos, los detalles del ErrorDeServicio contendrán más información, como cuando el token esté expirado o falte la notificación del appid.
401 Desautorizado InconsistentClientId La notificación clientId en la clave de identificador de Microsoft Store y la notificación appid en el token de acceso de Entra ID no coinciden.