Obter detalhes de um erro na sua aplicação

Use esse método na API de análise da Microsoft Store para obter dados detalhados de um erro específico para seu aplicativo no formato JSON. Este método só pode recuperar detalhes de erros que ocorreram nos últimos 30 dias. Dados de erro detalhados também estão disponíveis na seção Falhas do relatório de Saúde no Partner Center.

Antes de usar esse método, você deve primeiro usar o método get error reporting data para recuperar a ID do erro para o qual você deseja obter informações detalhadas.

Pré-requisitos

Para usar esse método, você precisa primeiro fazer o seguinte:

• Se ainda não o fez, preencha todos os pré-requisitos para a API de análise da Microsoft Store.
• Obtenha um token de acesso do Azure AD para usar no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.
• Obtenha a ID do erro para o qual você deseja obter informações detalhadas. Para obter este ID, utilize o método de obtenção de dados de relatórios de erros e utilize o valor do failureHash no corpo de resposta desse método.

Pedido

Sintaxe da solicitação

Método	Solicitar URI
Obtém	https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails

Cabeçalho da solicitação

Cabeçalho	Tipo	Descrição
Autorização	corda	Obrigatório O token de acesso do Azure AD no formato Bearer<token>.

Parâmetros de solicitação

Parâmetro	Tipo	Descrição	Obrigatório
applicationId	corda	A ID da Loja da aplicação para a qual pretende recuperar dados de erro detalhados. A ID da Loja está disponível na página de identidade do aplicativo no Partner Center. Um exemplo de ID de loja é 9WZDNCRFJ3Q8.	Sim
Hash de falha	corda	A ID exclusiva do erro para o qual você deseja obter informações detalhadas. Para obter este valor do erro no qual está interessado, utilize o método obter dados de relatório de erros e use o valor failureHash no corpo de resposta desse método.	Sim
data de início	data	A data de início do intervalo de datas para recuperação de dados de erro detalhados. O padrão é 30 dias antes da data atual. Observação: Este método só pode recuperar detalhes de erros que ocorreram nos últimos 30 dias.	Não
data de término	data	A data final no intervalo de datas de erro detalhado a recuperar. O padrão é a data atual.	Não
Início	Int	O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão, se não especificado, é 10000. Se houver mais linhas na consulta, o corpo da resposta incluirá um próximo link que você pode usar para solicitar a próxima página de dados.	Não
pular	Int	O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10 e skip=0 recupera as primeiras 10 linhas de dados, top=10 e skip=10 recupera as próximas 10 linhas de dados e assim por diante.	Não
filtro	corda	Uma ou mais declarações que filtram as linhas da resposta. Cada declaração contém um nome de campo do corpo da resposta e um valor que estão associados aos operadores eq ou ne, e as declarações podem ser combinadas usando e ou ou. Os valores de cadeia de caracteres devem estar entre aspas simples no parâmetro do filtro . Você pode especificar os seguintes campos do corpo da resposta: mercado data cabId cabExpirationTime Tipo de dispositivo modeloDispositivo osVersão osLançamento versão do pacote osConstruir	Não
ordenar por	corda	Uma instrução que ordena os valores de dados resultantes. A sintaxe é orderby=field [order],field [order],.... O parâmetro field pode ser uma das seguintes strings: mercado data cabId cabExpirationTime Tipo de dispositivo modeloDispositivo osVersão osLançamento versão do pacote osConstruir O parâmetro order é opcional e pode ser asc ou desc para especificar a ordem crescente ou decrescente para cada campo. O padrão é asc. Aqui está um exemplo orderby string: orderby=date,market	Não

Exemplo de solicitação

Os exemplos a seguir demonstram várias solicitações para obter dados de erro detalhados. Substitua o valor applicationId pelo Store ID da sua aplicação.

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>

Resposta

Corpo da resposta

Valor	Tipo	Descrição
Valor	conjunto	Uma matriz de objetos que contêm dados de erro detalhados. Para obter mais informações sobre os dados em cada objeto, consulte a seção de valores de detalhes do erro abaixo.
@nextLink	corda	Se houver páginas adicionais de dados, essa cadeia de caracteres conterá um URI que você pode usar para solicitar a próxima página de dados. Por exemplo, esse valor será retornado se o parâmetro superior da solicitação estiver definido como 10, mas houver mais de 10 linhas de erros para a consulta.
Contagem total	número inteiro	O número total de linhas no resultado de dados para a consulta.

Valores detalhados do erro

Os elementos na matriz Value contêm os seguintes valores.

Valor	Tipo	Descrição
applicationId	corda	O ID da Loja da aplicação para a qual obteve dados de erro detalhados.
Hash de falha	corda	O identificador exclusivo do erro.
nome da falha	corda	O nome da falha, que é composto por quatro partes: uma ou mais classes de problema, um código de verificação de exceção/bug, o nome da imagem onde a falha ocorreu e o nome da função associada.
data	corda	A primeira data do intervalo de datas para os dados de erro. Se a solicitação especificou um único dia, esse valor será essa data. Se a solicitação especificou uma semana, mês ou outro intervalo de datas, esse valor será a primeira data nesse intervalo de datas.
cabId	corda	O ID exclusivo do ficheiro CAB associado a este erro.
TempoDeExpiraçãoDoCabo	corda	A data e a hora em que o arquivo CAB expirou e não pode mais ser baixado, no formato ISO 8601.
mercado	corda	O código de país ISO 3166 do mercado de dispositivos.
osConstruir	corda	O número de compilação do SO no qual o erro ocorreu.
Versão do pacote	corda	A versão do pacote do aplicativo que está associada a esse erro.
modelo do dispositivo	corda	Uma cadeia de caracteres que especifica o modelo do dispositivo no qual o aplicativo estava sendo executado quando o erro ocorreu.
osVersão	corda	Uma das seguintes cadeias de caracteres que indica a versão do sistema operacional na qual o erro ocorreu: Telefone Windows 7.5 Windows Phone 8 Windows Phone 8.1 Telefone Windows 10 Janelas 8 Windows 8.1 Janelas 10 Janelas 11 Desconhecido
osLançamento do sistema operativo	corda	Uma das seguintes cadeias de caracteres que especifica a versão do sistema operativo ou o anel de voo (como uma subpopulação dentro da versão do sistema operativo) onde ocorreu o erro. Para Windows 11: Versão 2110 Para o Windows 10: Versão 1507 Versão 1511 Versão 1607 Versão 1703 Versão 1709 Versão 1803 Pré-visualização de Lançamento Insider Rápido Insider Lento Para o Windows Server 1709: RTM Para o Windows Server 2016: Versão 1607 Para Windows 8.1: Atualização 1 Para o Windows 7: Pacote de serviço 1 Se a versão do SO ou o anel de lançamento for desconhecido, este campo terá o valor Desconhecido.
Tipo de dispositivo	corda	Uma das seguintes cadeias de caracteres que especifica o tipo de dispositivo no qual o aplicativo estava sendo executado quando o erro ocorreu: Computador pessoal Telefone Console-Xbox Um Console-Xbox Série X Internet das coisas Holográfico Desconhecido
cabDescarregável	Booleano	Indica se o arquivo CAB pode ser baixado para esse usuário.

Observação

Este método só pode recuperar detalhes de erros que ocorreram nos últimos 30 dias.

Exemplo de solicitação e resposta

Os trechos de código a seguir demonstram alguns exemplos de solicitação e corpo de resposta JSON para essas solicitações.

Pedido de amostra

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>

Exemplo de resposta

{
    "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
}

Tópicos relacionados

• Relatório sobre a saúde
• Acessar dados analíticos usando os serviços da Microsoft Store
• Obter dados de relatório de erros
• Obter o rastro de pilha para um erro na sua aplicação
• Baixe o arquivo CAB em caso de erro na sua aplicação