Compartir a través de

Obtener detalles de un error en la aplicación

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 Salud en el Centro de socios.

Para poder usar este método, primero debe usar el método obtener los datos de informes de errores para recuperar el identificador del error para el que desea obtener información detallada.

Prerrequisitos

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

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de análisis de Microsoft Store.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener 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 obtener datos de informes de errores y utilice el valor de failureHash en el cuerpo de la respuesta de ese método.

Solicitud

Sintaxis de la solicitud

Método Solicitud de URI
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId cuerda / cadena Id. de la Tienda de la aplicación para la que quieres recuperar datos detallados de errores. El identificador de la tienda está disponible en el Centro de asociados, en la página de identidad de la aplicación . Un ID de tienda como ejemplo es 9WZDNCRFJ3Q8. Sí
HashDeError cuerda / cadena Identificador único del error para el que desea obtener información detallada. Para obtener este valor para el error que le interesa, utilice el método para obtener datos de informes de errores y emplee el valor failureHash en el cuerpo de la respuesta de dicho método. Sí
Fecha de inicio fecha Fecha de inicio en el rango de fechas de los datos de error detallados 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
fecha de finalización fecha Fecha de finalización del intervalo de fechas de datos de error detallados que se van a recuperar. El valor predeterminado es la fecha actual. No
Parte superior Int Número de filas de datos que se van a devolver en la solicitud. El valor máximo y el valor predeterminado si no se especifica es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo siguiente que puede usar para solicitar la siguiente página de datos. No
saltarse Int Número de filas que se van a omitir en la consulta. Use este parámetro para paginar 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
filtro cuerda / cadena Una o varias instrucciones que filtran las filas de la respuesta. Cada declaración contiene un nombre de campo del cuerpo de respuesta y un valor que están asociados a los operadores eq o ne. Además, las declaraciones se pueden combinar usando y o o. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro . Puede especificar los campos siguientes desde el cuerpo de la respuesta:

  • mercado
  • fecha
  • cabId
  • tiempoDeExpiraciónDelTaxi
  • tipoDeDispositivo
  • modeloDispositivo
  • versión del sistema operativo
  • osRelease
  • versiónDelPaquete
  • osBuild
 No
orderby cuerda / cadena Instrucción que ordena los valores de los datos de resultados. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede ser una de las siguientes cadenas:
  • mercado
  • fecha
  • cabId
  • tiempoDeExpiraciónDelTaxi
  • tipoDeDispositivo
  • modeloDispositivo
  • versión del sistema operativo
  • osRelease
  • versiónDelPaquete
  • 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. Sustituya el valor de applicationId por el identificador de tienda para su aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&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=00001111-aaaa-2222-bbbb-3333cccc4444&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 respuesta

Importancia Tipo Descripción
Importancia matriz 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 de valores de detalle de error a continuación.
@nextLink cuerda / cadena Si hay páginas adicionales de datos, esta cadena contiene un URI que 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 en la consulta.
Conteo Total entero Número total de filas en el resultado de los datos de la consulta.

Valores detallados del error

Los elementos de la matriz Value contienen los valores siguientes.

Importancia Tipo Descripción
applicationId cuerda / cadena ID de la tienda de la aplicación de la cual has recuperado datos de errores detallados.
HashDeError cuerda / cadena Identificador único del error.
nombreDeFalla cuerda / cadena 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.
fecha cuerda / cadena La primera fecha del intervalo de fechas para los datos de error. Si la solicitud especificó un solo día, este valor es esa fecha. Si la solicitud especificó una semana, mes u otro intervalo de fechas, este valor es la primera fecha de ese intervalo de fechas.
cabId cuerda / cadena Identificador único del archivo CAB asociado a este error.
horaDeExpiraciónDelCab cuerda / cadena Fecha y hora en que el archivo CAB ha expirado y ya no se puede descargar, en formato ISO 8601.
mercado cuerda / cadena El código de país ISO 3166 del mercado de dispositivos.
osBuild cuerda / cadena Número de compilación del sistema operativo en el que se produjo el error.
versiónDelPaquete cuerda / cadena La versión del paquete de la aplicación que está asociada a este error.
modelo del dispositivo cuerda / cadena Cadena que especifica el modelo del dispositivo en el que se estaba ejecutando la aplicación cuando se produjo el error.
osVersion cuerda / cadena 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
  • Desconocido
osRelease cuerda / cadena Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de despliegue (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
  • Acceso Rápido para Insiders
  • Insider Lento

Para Windows Server 1709:

  • RTM

Para Windows Server 2016:

  • Versión 1607

Para Windows 8.1:

  • Actualización 1

Para Windows 7:

  • Paquete de Servicio 1

Si se desconoce la versión del sistema operativo o el anillo de vuelo, este campo tiene el valor Desconocido.
tipo de dispositivo cuerda / cadena 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
  • Console-Xbox One
  • Console-Xbox Serie X
  • Internet de las Cosas
  • Holográfico
  • Desconocido
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 cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

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
}