Verwenden der Diagnose-API
Wichtig
Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.
Die App Center-Diagnose unterstützt mehrere API-Funktionen, die im Abschnitt "Abstürze und Fehler" der App Center-Seite "Swagger" aufgeführt sind. Lesen Sie die App Center-API-Dokumentation , um zu erfahren, wie Sie ein API-Token abrufen und Aufrufe an die App Center-API tätigen.
Hinweis
Die App Center-Diagnose-API unterstützt cors (Cross-Origin Resource Sharing, Cross-Origin Resource Sharing) nicht, sodass Anforderungen von Clients, die dies erfordern, z. B. Browser, fehlschlagen. Für die Interaktion mit der API über einen Browser können Sie einen Proxydienst unter Ihrer eigenen Domäne verwenden, der Anforderungen an die App Center-API weiterleitet.
Übergang zu den neuen APIs
Mit unserer Ankündigung zur allgemeinen Verfügbarkeit von App Center-Diagnosen im letzten Jahr und unserer UWP-Diagnose Verbesserungen haben wir einige Änderungen an unseren APIs vorgenommen, um eine verbesserte Back-End-Pipeline zum Verarbeiten Ihrer Abstürze und Fehler zu ermöglichen. Je nachdem, welche APIs Sie verwenden, sind möglicherweise einige Aktionen erforderlich, um einen reibungslosen Übergang zu gewährleisten.
Es gibt drei Arten von Abstürze-APIs:
- Stürzt APIs ab, die neuen APIs zugeordnet sind
- Stürzt apIs ab, die nicht mehr vorhanden sind
- Stürzt APIs ab, die unverändert bleiben
Stürzt APIs ab, die neuen APIs zugeordnet sind
Alte APIs, die im Abschnitt "Abstürze" aufgeführt sind, sind veraltet und wurden entfernt. Sie müssen die neuen Diagnose-APIs verwenden, wie in der folgenden Tabelle aufgeführt.
| Alte Abstürze-APIs | Neue Abstürze-API |
|---|---|
| GET/v0.1/apps/{owner_name}/{app_name}/retention_settings | GET/v0.1/apps/{owner_name}/{app_name}/errors/retention_settings |
| GET/v0.1/apps/{owner_name}/{app_name}/versions | GET/v0.1/apps/{owner_name}/{app_name}/analytics/versions |
| GET/v0.1/apps/{owner_name}/{app_name}/crashes/{crash_id}/attachments/{attachment_id}/text | GET/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/text |
| GET/v0.1/apps/{owner_name}/{app_name}/crashes/{crash_id}/attachments/{attachment_id}/location | GET/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments/{attachmentId}/location |
| GET/v0.1/apps/{owner_name}/{app_name}/crashes/{crash_id}/attachments | GET/v0.1/apps/{owner_name}/{app_name}/errors/{errorId}/attachments |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/stacktrace | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/stacktrace |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id}/stacktrace | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors/{errorId}/stacktrace |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id}/native/download | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors/{errorId}/download |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id} | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors/{errorId} |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id} | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId} |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups |
| DELETE/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id} | DELETE 0.1/apps/{app_id}/errors/errorGroups/{errorGroupId}/errors/{errorId} |
| PATCH/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id | PATCH/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId} |
| GET/v0.1/apps/{owner_name}/{app_name}/crashes_info | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crash_groups | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crash_groups/{crash_group_id}/crash_counts | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errorCountsPerDay |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crash_counts | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorCountsPerDay |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crash_groups/{crash_group_id}/models | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/models |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crash_groups/{crash_group_id}/operating_systems | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/operatingSystems |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id}/raw/location | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorGroups/{errorGroupId}/errors/{errorId}/location |
| GET/v0.1/apps/{owner_name}/{app_name}/crash_groups/{crash_group_id}/crashes/{crash_id}/native | GET /v0.1/apps/{ownerName}/{appName}/errors/errorGroups/{errorGroupId}/errors/{errorId}/download?format=text" |
| GET/v0.1/apps/{owner_name}/{app_name}/analytics/crashfree_device_percentages | GET/v0.1/apps/{owner_name}/{app_name}/errors/errorfreeDevicePercentages |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_groups_info | GET/v0.1/apps/{owner_name}/{app_name}/Diagnose/symbol_groups_info |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_groups/{symbol_group_id} | GET/v0.1/apps/{owner_name}/{app_name}/Diagnose/symbol_groups/{symbol_group_id} |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_groups | GET/v0.1/apps/{owner_name}/{app_name}/Diagnose/symbol_groups |
Unveränderte APIs stürzt ab
Es gibt einige Abstürze-APIs, die in der neuen Pipeline unverändert bleiben. Die folgenden APIs funktionieren weiterhin wie erwartet, und es ist derzeit keine Aktion erforderlich.
| Unveränderte APIs stürzt ab |
|---|
| GET/v0.1/apps/{owner_name}/{app_name}/symbols/{symbol_id}/status |
| GET/v0.1/apps/{owner_name}/{app_name}/symbols/{symbol_id}/location |
| POST/v0.1/apps/{owner_name}/{app_name}/symbols/{symbol_id}/ignore |
| GET/v0.1/apps/{owner_name}/{app_name}/symbols/{symbol_id} |
| GET/v0.1/apps/{owner_name}/{app_name}/symbols |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}/location |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id} |
| PATCH/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id} |
| DELETE/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id} |
| GET/v0.1/apps/{owner_name}/{app_name}/symbol_uploads |
| POST/v0.1/apps/{owner_name}/{app_name}/symbol_uploads |