Udostępnij przez


Pobieranie aplikacji

Użyj tej metody w interfejsie API Microsoft Store do przesyłania, aby pobrać informacje o określonej aplikacji zarejestrowanej na Twoim koncie w Centrum Partnerów.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiłeś(-łaś), zrealizuj wszystkie wymagania wstępne dla API przesyłania do Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

Żądanie

Ta metoda ma następującą składnię. Zapoznaj się z poniższymi sekcjami, aby zapoznać się z przykładami użycia i opisami nagłówka i treści żądania.

Metoda Żądanie URI
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Nazwa Typ Opis
applicationId (identyfikator aplikacji) sznurek To jest wymagane. Identyfikator sklepu aplikacji do pobrania. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.

Ciało żądania

Nie należy podawać treści żądania dla tej metody.

Przykład zapytania

W poniższym przykładzie pokazano, jak pobrać informacje o aplikacji o identyfikatorze Store ID wartym 9NBLGGH4R315.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315 HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

W poniższym przykładzie pokazano treść odpowiedzi JSON dla pomyślnego wywołania tej metody. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz Zasób aplikacji.

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

Kody błędów

Jeśli nie można pomyślnie ukończyć żądania, odpowiedź będzie zawierać jeden z następujących kodów błędów HTTP.

Kod błędu Opis
404 Nie można odnaleźć określonej aplikacji.
409 Aplikacja korzysta z funkcji Centrum partnerskiego, która nie jest aktualnie wspierana przez interfejs API przesyłania do Microsoft Store.