Получение пакетных авиарейсов для приложения

2025-05-01

Используйте этот метод в API отправки Microsoft Store, чтобы перечислить рейсы пакетов для приложения, зарегистрированного в учетной записи Центра партнеров. Для получения дополнительной информации о пакетных рейсах см. раздел .

Предпосылки

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

Если это еще не сделано, выполните все необходимые требования для API публикации в Microsoft Store.
Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена можно получить новый токен.

Просьба

Этот метод имеет следующий синтаксис. В следующих разделах приведены примеры использования и описания текста заголовка и запроса.

Метод	Запрос URI
ПОЛУЧАЙ	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights`

Заголовок запроса

Заголовок	Тип	Описание
Авторизация	струна	Обязательное. Токен доступа Azure AD в формате Bearer<token>.

Параметры запроса

Имя	Тип	Описание	Обязательно
applicationId	струна	Идентификатор магазина приложения, для которого требуется получить рейсы пакетов. Для получения дополнительных сведений об идентификаторе магазина см. Просмотр данных об идентичности приложения.	Да
Верх	инт	Количество элементов, возвращаемых в запросе (т. е. количество возвращаемых пакетных рейсов). Если в вашем аккаунте больше пакетных рейсов, чем указанное в запросе значение, ответное сообщение содержит относительный путь URI, который можно добавить к URI метода, чтобы запросить данные на следующей странице.	нет
пропустить	инт	Количество элементов, которые нужно обойти в запросе, прежде чем возвращать остальные элементы. Используйте этот параметр для перелистывания наборов данных. Например, top=10 и skip=0 извлекает элементы от 1 до 10, top=10 и skip=10 извлекает элементы 11–20 и т. д.	нет

Основное содержание запроса

Не указывайте тело запроса для этого метода.

Примеры запросов

В следующем примере показано, как перечислить все рейсы пакетов для приложения.

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

В следующем примере показано, как перечислить первый тестовый пакет для приложения.

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

Ответ

В следующем примере показано тело ответа JSON, возвращаемое успешным запросом первого пакетного полета для приложения, у которого всего три пакетных полета. Дополнительные сведения о значениях в тексте ответа см. в следующем разделе.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Основная часть ответа

Ценность	Тип	Описание
@nextLink	струна	Если есть дополнительные страницы данных, эта строка содержит относительный путь, который можно добавить к базовому `https://manage.devcenter.microsoft.com/v1.0/my/` URI запроса, чтобы запросить следующую страницу данных. Например, если в параметре верхней части исходного текста запроса установлено значение 2, но для приложения доступно 4 рейса для пакетов, текст ответа будет содержать значение @nextLink, равное `applications/{applicationid}/listflights/?skip=2&top=2`, что указывает на возможность сделать запрос `https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2` для получения следующих 2 рейсов для пакетов.
ценность	массив	Массив объектов, предоставляющих информацию о рейсах пакетов для указанного приложения. Чтобы получить дополнительную информацию о данных в каждом объекте, см. ресурс Flight .
общееКоличество	инт	Общее количество строк в результатах для запроса (то есть общее количество пакетных авиарейсов для указанного приложения).

Коды ошибок

Если запрос не может быть выполнен успешно, ответ будет содержать один из следующих кодов ошибок HTTP.

Код ошибки	Описание
404	Рейсов в составе пакета не найдено.
409	Приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.