Obtener los detalles de un error en la aplicación

Artículo
07/05/2024

Usa este método en la API de análisis de Microsoft Store para obtener datos detallados de un error específico para tu aplicación en formato JSON. Este método solo puede recuperar detalles de los errores que se produjeron en los últimos 30 días. Los datos detallados de errores también están disponibles en la sección Errores del informe de mantenimiento en el Centro de partners.

Para poder usar este método, primero debe usar el método get error reporting data para recuperar el identificador del error para el que desea obtener información detallada.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
Obtenga el identificador del error para el que desea obtener información detallada. Para obtener este identificador, use el método de obtención de datos de informes de errores y use el valor failureHash en el cuerpo de la respuesta de ese método.

Solicitar

Sintaxis de la solicitud

Método	URI de solicitud
GET	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails`

Encabezado de solicitud

Encabezado	Tipo	Descripción
Autorización	string	Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Parámetro	Tipo	Descripción	Obligatorio
applicationId	string	Id. de la Tienda de la aplicación para la que quieres recuperar datos detallados de errores. El Id. de Store está disponible en la página Identidad de la aplicación del Centro de partners. Un ejemplo de Id. de Store es 9WZDNCRFJ3Q8.	Sí
failureHash	string	Identificador único del error para el que desea obtener información detallada. Para obtener este valor para el error que le interesa, use el método obtener datos de informes de errores y use el valor failureHash en el cuerpo de la respuesta de ese método.	Sí
startDate	date	Fecha de inicio en el intervalo de fechas de datos de error detallados que se van a recuperar. El valor predeterminado es 30 días antes de la fecha actual. Nota: Este método solo puede recuperar detalles de los errores que se produjeron en los últimos 30 días.	No
endDate	date	Fecha de finalización del intervalo de fechas de datos de error detallados que se van a recuperar. La fecha actual es el valor predeterminado.	No
superior	int	Número de filas de datos que se van a devolver en la solicitud. Si no se especifica, el valor predeterminado y el valor máximo es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo “Siguiente” que puedes usar para solicitar la siguiente página de datos.	No
skip	int	Número de filas que se omiten en la consulta. Usa este parámetro para pasar de página en conjuntos de datos grandes. Por ejemplo, top=10 y skip=0 recupera las primeras 10 filas de datos, top=10 y skip=10 recupera las siguientes 10 filas de datos, etc.	No
filter	string	Una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo de la respuesta y el valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante y u o. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro. Puedes especificar los campos siguientes desde el cuerpo de la respuesta: market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild	No
orderby	string	Instrucción que ordena los valores de los datos en los resultados. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede estar formado por una de las siguientes cadenas: market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild El parámetro order es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc. Este es un ejemplo de cadena orderby: orderby=date,market	No

Ejemplo de solicitud

En los ejemplos siguientes se muestran varias solicitudes para obtener datos detallados de errores. Reemplaza el valor applicationId por el Id. de Store de tu aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'Windows.Desktop' HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

Cuerpo de la respuesta

Valor	Tipo	Descripción
Valor	array	Matriz de objetos que contienen datos detallados de errores. Para obtener más información sobre los datos de cada objeto, consulte la sección valores de detalle de error a continuación.
@nextLink	string	Si hay páginas adicionales de datos, esta cadena contiene un URI que se puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro superior de la solicitud se establece en 10, pero hay más de 10 filas de errores para la consulta.
TotalCount	integer	Número total de filas que figura en el resultado de datos de la consulta.

Valores de detalles de error

Los elementos de la matriz Value contienen los valores siguientes.

Valor	Tipo	Descripción
applicationId	string	Id. de la Tienda de la aplicación para la que recuperó datos detallados de error.
failureHash	string	El identificador único del error.
failureName	string	Nombre del error, que consta de cuatro partes: una o varias clases de problemas, un código de comprobación de errores o excepciones, el nombre de la imagen donde se produjo el error y el nombre de la función asociada.
date	string	La primera fecha del intervalo de fechas para los datos de error. Si la solicitud especificaba un solo día, este valor es esa fecha. Si la solicitud especificaba una semana, un mes u otro intervalo de fechas, este valor es la primera fecha de ese intervalo de fechas.
cabId	string	Identificador único del archivo CAB asociado a este error.
cabExpirationTime	string	Fecha y hora en que el archivo CAB ha expirado y ya no se puede descargar, en formato ISO 8601.
market	string	El código de país ISO 3166 del mercado del dispositivo.
osBuild	string	Número de compilación del sistema operativo en el que se produjo el error.
packageVersion	string	La versión del paquete de la aplicación que está asociada a este error.
deviceModel	string	Cadena que especifica el modelo del dispositivo en el que se estaba ejecutando la aplicación cuando se produjo el error.
osVersion	string	Una de las siguientes cadenas que indica la versión del sistema operativo en la que se produjo el error: Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8.1 Windows 10 Windows 11 Unknown
osRelease	string	Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de distribución de paquetes piloto (como subpoblación dentro de la versión del sistema operativo) en la que se produjo el error. Para Windows 11: versión 2110 Para Windows 10: Versión 1507 Versión 1511 Versión 1607 Versión 1703 Versión 1709 Versión 1803 Versión preliminar Modo anticipado del Insider Modo aplazado del Insider Para Windows Server 1709: RTM Para Windows Server 2016: Versión 1607 Para Windows 8.1: Actualización 1 Para Windows 7: Service Pack 1 Si se desconoce la versión del sistema operativo o el anillo de distribución de paquestes piloto, este campo tiene el valor Desconocido.
deviceType	string	Una de las siguientes cadenas que especifica el tipo del dispositivo en el que se estaba ejecutando la aplicación cuando se produjo el error: PC Teléfono Consola-Xbox One Consola-Xbox Series X IoT Holográfico Unknown
cabDownloadable	Booleano	Indica si el archivo CAB se puede descargar para este usuario.

Nota:

Este método solo puede recuperar detalles de los errores que se produjeron en los últimos 30 días.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y del cuerpo de la respuesta en formato JSON de esa solicitud.

Solicitud de muestra

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012345-5dbc9-b12f-c124-9d9810f05d8b&startDate=2022-06-30&endDate=2022-07-28&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "date": "2022-07-12 00:00:00",
            "cabExpirationTime": "2022-08-16 01:37:00",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1180087848576586304",
            "market": "MX",
            "osBuild": "10.0.19043",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Inspiron 15-3567",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H1",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "Intel Core i5-7200U CPU @ 2.50GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-13 00:00:00",
            "cabExpirationTime": "2022-08-17 13:35:53",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "2058585545558157474",
            "market": "RO",
            "osBuild": "10.0.22622",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Vostro 5502",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "11th Gen Intel Core i5-1135G7 @ 2.40GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-14 00:00:00",
            "cabExpirationTime": "2022-08-18 07:27:06",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1940204079766793391",
            "market": "IN",
            "osBuild": "10.0.19044",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Generic Desktop",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H2",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Pentium",
            "cpuName": "Intel Pentium CPU G630 @ 2.70GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-17 00:00:00",
            "cabExpirationTime": "2022-08-21 10:04:16",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1197051093472061859",
            "market": "ES",
            "osBuild": "10.0.22621",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Microsoft Corporation-Surface Pro 3",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-4650U CPU @ 1.70GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-20 00:00:00",
            "cabExpirationTime": "2022-08-24 12:40:05",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1332886311327579782",
            "market": "RU",
            "osBuild": "6.3.9600",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "ASUSTeK COMPUTER INC.-K75VJ",
            "osVersion": "Windows 8.1",
            "osRelease": "RTM",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-3630QM CPU @ 2.40GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": ""
        }
    ],
    "TotalCount": 5
}

Compartir a través de

Obtener los detalles de un error en la aplicación

Requisitos previos

Solicitar

Sintaxis de la solicitud

Encabezado de solicitud

Parámetros de solicitud

Ejemplo de solicitud

Respuesta

Cuerpo de la respuesta

Valores de detalles de error

Ejemplo de solicitud y respuesta

Solicitud de muestra

Respuesta de ejemplo

Comentarios

Recursos adicionales

Compartir a través de

Obtener los detalles de un error en la aplicación

Requisitos previos

Solicitar

Sintaxis de la solicitud

Encabezado de solicitud

Parámetros de solicitud

Ejemplo de solicitud

Respuesta

Cuerpo de la respuesta

Valores de detalles de error

Ejemplo de solicitud y respuesta

Solicitud de muestra

Respuesta de ejemplo

Temas relacionados

Comentarios

Recursos adicionales