Udostępnij przez

Zarezerwuj lot pakietowy

Użyj tej metody w interfejsie API przesyłania aplikacji w sklepie Microsoft Store, aby pobrać dane dla lotu pakietów 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}/flights/{flightId}

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 zawierającej pakiet testowy, który chcesz uzyskać. Identyfikator sklepu dla aplikacji jest dostępny w Centrum partnerskim.
flightId (identyfikator lotu) sznurek To jest wymagane. Identyfikator lotu pakietu do pobrania. Ten identyfikator jest dostępny w danych odpowiedzi dla żądań tworzenia pakietu lotu i pobierania pakietów dla aplikacji. W przypadku lotu utworzonego w Centrum partnerskim ten identyfikator jest również dostępny w adresie URL strony lotu w Centrum partnerskim.

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 locie pakietu z identyfikatorem 43e448df-97c9-4a43-a0bc-2a445e736bcd dla aplikacji o wartości identyfikatora sklepu 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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 następujące sekcje.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Ciało odpowiedzi

Wartość Typ Opis
flightId (identyfikator lotu) sznurek Identyfikator lotu pakietu. Ta wartość jest dostarczana przez Centrum partnerskie.
przyjaznaNazwa sznurek Nazwa pakietu lotu określona przez dewelopera.
ostatnioOpublikowaneZlecenieLotu przedmiot Obiekt, który zawiera informacje o ostatnim opublikowanym przesłaniu dla pakietu lotu. Aby uzyskać więcej informacji, zobacz sekcję Obiekt przesyłania poniżej.
zgłoszenie lotu w toku przedmiot Obiekt, który zawiera informacje o bieżącym oczekiwaniu na przesłanie pakietu do lotu. Aby uzyskać więcej informacji, zobacz sekcję Obiekt przesyłania poniżej.
groupIds (identyfikatory grup) układ Tablica ciągów zawierających identyfikatory grup lotów skojarzonych z lotem pakietowym. Aby uzyskać więcej informacji na temat grup lotów, zobacz Pakiety lotów.
rangaWyższaNiż sznurek Przyjazna nazwa lotu pakietowego, który jest sklasyfikowany bezpośrednio niżej niż aktualny lot pakietowy. Aby uzyskać więcej informacji na temat klasyfikacji grup lotów, zobacz Pakiety lotów.

Obiekt przesyłania

Wartości lastPublishedFlightSubmission i pendingFlightSubmission w treści odpowiedzi zawierają obiekty dostarczające informacji o zasobach związanych z przesłaniem pakietu do lotu. Te obiekty mają następujące wartości.

Wartość Typ Opis
id sznurek Identyfikator zgłoszenia.
lokalizacja zasobu sznurek Ścieżka względna, którą można dołączyć do base https://manage.devcenter.microsoft.com/v1.0/my/ request URI, aby pobrać pełne dane do przesłania.

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
400 Żądanie jest nieprawidłowe.
404 Nie można odnaleźć określonego lotu pakietu.
409 Aplikacja korzysta z funkcjonalności Centrum partnerskiego, która obecnie nie jest obsługiwana przez API przesyłania Microsoft Store.
  • Last updated on