Abrufen einer App
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Informationen zu einer bestimmten App abzurufen, die für Ihr Partner Center-Konto registriert ist.
Voraussetzungen
Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:
- Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API aus.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
Anfordern
Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.
| Methode | Anforderungs-URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} |
Anforderungsheader
| Header | Typ | Beschreibung |
|---|---|---|
| Autorisierung | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>. |
Anforderungsparameter
| Name | Typ | Beschreibung |
|---|---|---|
| applicationId | Zeichenfolge | Erforderlich. Die Store-ID der abzurufenden App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Anforderungsbeispiel
Im folgenden Beispiel wird veranschaulicht, wie Informationen zu einer App mit dem Store-ID-Wert 9NBLGGH4R315 abgerufen werden.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315 HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in der Anwendungsressource.
{
"id": "9NBLGGH4R315",
"primaryName": "ApiTestApp",
"packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
"packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
"publisherName": "CN=…",
"firstPublishedDate": "1601-01-01T00:00:00Z",
"lastPublishedApplicationSubmission": {
"id": "1152921504621086517",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
},
"pendingApplicationSubmission": {
"id": "1152921504621243487",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
},
"hasAdvancedListingPermission": false
}
Fehlercodes
Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.
| Fehlercode | BESCHREIBUNG |
|---|---|
| 404 | Die angegebene Anwendung konnte nicht gefunden werden. |
| 409 | Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird. |