Поделиться через

Получение тестового пакета

  • Статья

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

Необходимые компоненты

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

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

Запросить

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

Способ URI запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

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

Верхний колонтитул Тип Описание
Авторизация строка Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

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

Имя. Тип Описание
applicationId строка Обязательный. Идентификатор магазина приложения, содержащего тестовый пакет, который требуется получить. Идентификатор Магазина для приложения доступен в Центре партнеров.
flightId строка Обязательный. Идентификатор тестового пакета, который требуется получить. Этот идентификатор доступен в данных ответа для запросов на создание тестового пакета и получение пакетов для приложения. Для полета, созданного в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы тестовой страницы в Центре партнеров.

Текст запроса

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

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

В следующем примере показано, как получить сведения о полете пакета с идентификатором 43e48df-97c9-4a43-a0bc-2a445e736bcd для приложения со значением идентификатора Магазина 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>

Response

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

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

Текст ответа

Значение Тип Описание
flightId строка Идентификатор для тестового пакета. Это значение предоставляется Центром партнеров.
friendlyName строка Имя тестового пакета, указанное разработчиком.
lastPublishedFlightSubmission объект Объект, предоставляющий сведения о последней опубликованной отправке для тестового пакета. Дополнительные сведения см. в разделе "Объект отправки" ниже.
pendingFlightSubmission объект Объект, предоставляющий сведения о текущей ожидающей отправке для тестового пакета. Дополнительные сведения см. в разделе "Объект отправки" ниже.
groupIds array Массив строк, содержащих идентификаторы групп полетов, связанных с полетом пакета. Дополнительные сведения о группах полетов см. в разделе "Пакеты полетов".
rankHigherThan строка Понятное имя тестового пакета, которое ранжируется сразу же ниже текущего тестового пакета. Дополнительные сведения о ранжировании групп полетов см. в разделе "Пакеты полетов".

Объект отправки

Значения lastPublishedFlightSubmission и pendingFlightSubmission в теле ответа содержат объекты, которые предоставляют сведения о ресурсе отправки для тестового пакета. Эти объекты имеют следующие значения.

Значение Тип Описание
id строка Идентификатор отправки.
resourceLocation строка Относительный путь, который можно добавить к URI базового https://manage.devcenter.microsoft.com/v1.0/my/ запроса, чтобы получить полные данные для отправки.

Коды ошибок

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

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