Obtenir les informations sur une erreur de votre application
Utilisez cette méthode dans l’API d’analytique 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 peut récupérer que les détails des erreurs qui se sont produites au cours des 30 derniers jours. Les données d’erreur détaillées sont également disponibles dans la section Échecs du rapport d’intégrité dans l’Espace partenaires.
Avant de pouvoir utiliser cette méthode, vous devez d’abord utiliser la méthode de données de rapport d’erreurs get pour récupérer l’ID de l’erreur pour laquelle vous souhaitez obtenir des informations détaillées.
Prérequis
Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :
- Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse de la Boutique Microsoft.
- Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour 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 expiré, vous pouvez en obtenir un nouveau.
- Obtenez l’ID de l’erreur pour laquelle vous souhaitez obtenir des informations détaillées. Pour obtenir cet ID, utilisez la méthode de données de rapport d’erreurs get 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/failuredetails |
En-tête de requête
| En-tête | Type | Description |
|---|---|---|
| Autorisation | string | Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>. |
Paramètres de la demande
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| applicationId | string | ID Store de l’application pour laquelle vous souhaitez récupérer des données d’erreur détaillées. L’ID store est disponible sur la page Identité de l’application dans l’Espace partenaires. Un exemple d’ID store est 9WZDNCRFJ3Q8. | Oui |
| failureHash | string | ID unique de l’erreur pour laquelle vous souhaitez obtenir des informations détaillées. Pour obtenir cette valeur pour l’erreur qui vous intéresse, utilisez la méthode de données de rapport d’erreurs get et utilisez la valeur failureHash dans le corps de la réponse de cette méthode. | Oui |
| startDate | date | Date de début dans la plage de dates des données d’erreur détaillées à récupérer. La valeur par défaut est de 30 jours avant la date actuelle.Remarque : cette méthode ne peut récupérer que les détails des erreurs qui se sont produites au cours des 30 derniers jours. | Non |
| endDate | date | Date de fin dans la plage de dates des données d’erreur détaillées à récupérer. La valeur par défaut est la date actuelle. | Non |
| haut | int | Nombre de lignes de données à retourner dans la requête. La valeur maximale, soit la valeur par défaut, est 10000 (si cette valeur n’est pas spécifiée). S’il existe plus de lignes dans la requête, le corps de la réponse inclut un lien suivant que vous pouvez utiliser pour demander la page suivante de données. | Non |
| skip | int | Nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir des jeux de données volumineux. Par exemple, top=10 et skip=0 récupère les 10 premières lignes de données, top=10 et skip=10 récupère les 10 lignes de données suivantes, et ainsi de suite. | Non |
| filter | string | Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un nom de champ à partir du corps de la réponse et une valeur associés aux opérateurs eq ou ne, et les instructions peuvent être combinées à l’aide et ou ou. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre. Vous pouvez spécifier les champs suivants à partir du corps de la réponse :
|
Non |
| orderby | string | Instruction qui commande les valeurs de données de résultat. La syntaxe est orderby=field [order],field [order],.... Le paramètre de champ peut être l’une des chaînes suivantes :
Le paramètre d’ordre est facultatif et peut être asc ou desc pour 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 illustrent plusieurs demandes d’obtention de données d’erreur détaillées. Remplacez la valeur applicationId par l’ID Store de votre application.
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>
Response
Response body
| Valeur | Type | Description |
|---|---|---|
| active | tableau | Tableau d’objets qui contiennent des données d’erreur détaillées. Pour plus d’informations sur les données de chaque objet, consultez la section des valeurs détaillées d’erreur ci-dessous. |
| @nextLink | string | S’il existe des pages de données supplémentaires, cette chaîne contient un URI que vous pouvez utiliser pour demander la page suivante des données. Par exemple, cette valeur est retournée si le paramètre supérieur de la requête est défini sur 10, mais qu’il existe plus de 10 lignes d’erreurs pour la requête. |
| TotalCount | entier | Nombre total de lignes dans le résultat des données de la requête. |
Valeurs détaillées d’erreur
Les éléments du tableau Valeur contiennent les valeurs suivantes.
| Valeur | Type | Description |
|---|---|---|
| applicationId | string | ID Store de l’application pour laquelle vous avez récupéré des données d’erreur détaillées. |
| failureHash | string | Identificateur unique de l’erreur. |
| failureName | string | Nom de l’échec, constitué de quatre parties : une ou plusieurs classes de problème, un code d’exception/code de vérification de bogue, le nom de l’image où l’échec s’est produit et le nom de la fonction associée. |
| date | string | La première date de la plage de dates pour les données d’erreur. Si la demande a spécifié un jour unique, cette valeur est cette date. Si la requête a spécifié une semaine, un mois ou une autre plage de dates, cette valeur est la première date de cette plage de dates. |
| cabId | string | ID unique du fichier CAB associé à cette erreur. |
| cabExpirationTime | string | Date et heure à laquelle le fichier CAB a expiré et ne peut plus être téléchargé, au format ISO 8601. |
| market | string | Code pays ISO 3166 du marché de l’appareil. |
| osBuild | string | Numéro de build du système d’exploitation sur lequel l’erreur s’est produite. |
| packageVersion | string | Version du package de l’application associé à cette erreur. |
| deviceModel | string | Chaîne qui spécifie le modèle de l’appareil sur lequel l’application s’exécutait lorsque l’erreur s’est produite. |
| osVersion | string | Une des chaînes suivantes qui indique la version du système d’exploitation sur laquelle l’erreur s’est produite :
|
| osRelease | string | Une des chaînes suivantes qui spécifie la version du système d’exploitation ou la boucle de distribution de versions d’évaluation (sous-remplissage dans la version du système d’exploitation) sur laquelle l’erreur s’est produite. Pour Windows 11 : Version 2110 Pour Windows 10 :
Pour Windows Server 1709 :
Pour Windows Server 2016 :
Pour Windows 8.1 :
Pour Windows 7 :
Si la version du système d’exploitation ou la boucle de distribution de versions d’évaluation est inconnue, ce champ a la valeur Inconnu. |
| deviceType | string | L’une des chaînes suivantes qui spécifie le type de l’appareil sur lequel l’application s’exécutait lorsque l’erreur s’est produite :
|
| cabDownloadable | Boolean | Indique si le fichier CAB est téléchargeable pour cet utilisateur. |
Remarque
Cette méthode ne peut récupérer que les détails des erreurs qui se sont produites au cours des 30 derniers jours.
Exemple de requête et de réponse
Les extraits de code suivants illustrent un exemple de corps de requête et de réponse JSON pour cette requête.
Exemple de requête
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>
Exemple de réponse
{
"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
}