Obtenir les informations sur une erreur de votre application de bureau

  • Article

Utilisez cette méthode dans l’API d’analyse du Microsoft Store pour obtenir des données détaillées pour une erreur spécifique pour votre application au format JSON. Cette méthode ne récupère que les informations concernant les erreurs survenues dans les 30 derniers jours. Des données d’erreur détaillées sont également disponibles dans le rapport d’intégrité pour les applications de bureau dans l’Espace partenaires.

Pour utiliser cette méthode, vous devez d’abord utiliser la méthode Obtenir les données de rapport d’erreurs afin de récupérer l’ID de l’erreur sur laquelle vous souhaitez des informations détaillées.

Prérequis

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API d’analyse du Microsoft Store.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.
  • Récupérez l’ID de l’erreur sur laquelle vous souhaitez des informations détaillées. Pour ce faire, utilisez la méthode Obtenir les données de rapport d’erreurs et utilisez la valeur failureHash dans le corps de la réponse de cette méthode.

Requête

Syntaxe de la requête

Méthode URI de demande
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD sous la formeJeton> du porteur<.

Paramètres de la demande

Paramètre Type Description Obligatoire
applicationId string ID de produit de l’application de bureau pour laquelle vous souhaitez récupérer les détails de l’erreur. Pour obtenir l’ID de produit d’une application de bureau, ouvrez n’importe quel rapport d’analytique pour votre application de bureau dans l’Espace partenaires (par exemple, le rapport d’intégrité) et récupérez l’ID de produit à partir de l’URL. Oui
failureHash string ID de l’erreur sur laquelle vous souhaitez des informations détaillées. Pour obtenir la valeur correspondant à l’erreur qui vous intéresse, utilisez la méthode Obtenir les données de rapport d’erreurs et utilisez la valeur failureHash dans le corps de la réponse de cette méthode. Oui
startDate Date Date de début des données à récupérer concernant l’erreur. La valeur par défaut est de 30 jours avant la date actuelle.

Note: Cette méthode peut uniquement récupérer les détails des erreurs qui se sont produites au cours des 30 derniers jours.		 Non
endDate Date Date de fin des données à récupérer concernant l’erreur. La valeur par défaut est la date actuelle. Non
top int Le nombre de lignes de données à renvoyer dans la requête. La valeur maximale et la valeur par défaut en l’absence de définition est 10000. Si la requête comporte davantage de lignes, le corps de la réponse inclut un lien sur lequel vous cliquez pour solliciter la page suivante de données. Non
skip int Le nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir de grands ensembles de données. Par exemple, indiquez top=10 et skip=0 pour obtenir les 10 premières lignes de données, top=10 et skip=10 pour obtenir les 10 lignes suivantes, et ainsi de suite. Non
filter string Une ou plusieurs instructions qui filtrent les lignes de la réponse. Chaque instruction contient un nom de champ à partir du corps de la réponse et de la valeur associés aux opérateurs eq ou ne, et les instructions peuvent être combinées à l’aide de et ou . Les valeurs de chaîne doivent être entourées par des guillemets dans le paramètre filter. Vous pouvez spécifier les champs suivants à partir du corps de la réponse :

  • Marché
  • date
  • cabIdHash
  • cabExpirationTime
  • deviceType
  • deviceModel
  • osVersion
  • osRelease
  • applicationVersion
  • osBuild
  • fileName
 Non
orderby string Instruction commandant les valeurs des données de résultats. La syntaxe est orderby=field [order],field [order],.... Le paramètre field peut être l’une des chaînes suivantes :
  • Marché
  • date
  • cabIdHash
  • cabExpirationTime
  • deviceType
  • deviceModel
  • osVersion
  • osRelease
  • applicationVersion
  • osBuild
  • fileName

Le paramètre order, facultatif, peut comporter les valeurs asc ou desc afin de spécifier l’ordre croissant ou décroissant pour chaque champ. La valeur par défaut est asc.

Voici un exemple de chaîne orderby : orderby=date,market

 Non

Exemple de requête

Les exemples suivants fournissent plusieurs requêtes permettant de récupérer des données d’erreur. Remplacez la valeur applicationId par l’ID de produit de votre application de bureau.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&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/desktop/failuredetails?applicationId=10238467886765136388&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 'PC' HTTP/1.1
Authorization: Bearer <your access token>

response

Response body

Valeur Type Description
Valeur tableau Tableau d’objets comportant des données d’erreur détaillées. Pour plus d’informations sur les données de chaque objet, consultez la section Valeurs des informations d’erreur ci-dessous.
@nextLink string S’il existe des pages supplémentaires de données, cette chaîne comporte un URI que vous pouvez utiliser pour solliciter la page suivante de données. Par exemple, cette valeur est renvoyée si le paramètre top de la requête est défini sur 10, mais que plus de 10 lignes d’erreur sont associées à la requête.
TotalCount entier Nombre total de lignes dans les résultats de la requête.

Valeurs des informations d’erreur

Les éléments du tableau Value comportent les valeurs suivantes :

Valeur Type Description
applicationId string ID de produit de l’application de bureau pour laquelle vous avez récupéré les détails de l’erreur.
failureHash string Identificateur unique de l’erreur.
failureName string Nom de l’échec, qui se compose de quatre parties : une ou plusieurs classes de problèmes, un code d’exception/bogue case activée, le nom de l’image où l’échec s’est produit et le nom de la fonction associée.
Date string Date de début des données d’erreur. Si la requête spécifiait un jour précis, cette valeur correspond à la date. Si la requête était relative à une semaine, un mois ou toute autre plage de dates, cette valeur correspond à la première date de la plage de dates.
cabIdHash string Hachage d’ID unique du fichier CAB associé à cette erreur.
cabExpirationTime string Date et heure auxquelles le fichier CAB est arrivé à expiration et n’est plus téléchargeable au format ISO 8601.
market string Code pays ISO 3166 du marché des appareils.
osBuild string Numéro de version du système d’exploitation sur lequel l’erreur s’est produite.
applicationVersion string Version de l’exécutable de l’application dans laquelle l’erreur s’est produite.
deviceModel string Chaîne identifiant le modèle d’appareil sur lequel l’application s’exécutait lorsque l’erreur s’est produite.
osVersion string Une des chaînes suivantes qui spécifie la version du système d’exploitation sur laquelle l’application de bureau est installée :

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Unknown
osRelease string Une des chaînes suivantes qui spécifie la version du système d’exploitation ou l’anneau de version d’évaluation (en tant que sous-population dans la version du système d’exploitation) sur laquelle l’erreur s’est produite.

Pour Windows 11 : version 2110

Pour Windows 10 :

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Version 1803
  • Version préliminaire
  • Insider Fast
  • Insider Slow

Pour Windows Server 1709 :

  • RTM

Pour Windows Server 2016 :

  • Version 1607

Pour Windows 8.1 :

  • Update 1

Pour Windows 7 :

  • Service Pack 1

Si la version du système d’exploitation ou l’anneau de version d’évaluation est inconnue, ce champ a la valeur Inconnu.
deviceType string Une des chaînes suivantes qui indique le type d’appareil sur lequel l’erreur s’est produite :

  • PC
  • Serveur
  • Unknown
cabDownloadable Boolean Indique si le fichier CAB est téléchargeable par cet utilisateur.
fileName string Nom du fichier exécutable de l’application de bureau pour laquelle vous avez récupéré les détails de l’erreur.

Exemple de réponse

L’exemple suivant représente un corps de réponse JSON pour cette requête.

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}