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

  • Статья

Используйте этот метод в API отправки в Microsoft Store для получения состояния отправки тестового пакета. Подробнее о процессе создания отправки тестового пакета с помощью API отправки в Microsoft Store см. в разделе Управление отправкой тестового пакета.

Предварительные требования

Для использования этого метода сначала необходимо сделать следующее:

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

Запрос

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

Метод Универсальный код ресурса (URI) запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status

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

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

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

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

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

Предоставлять текст запроса для этого метода не требуется.

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

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

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>

Ответ

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

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Текст ответа

Значение Тип Описание
status строка Состояние отправки. Может иметь одно из следующих значений:
  • Нет
  • Отменено
  • PendingCommit (Ожидание фиксации)
  • CommitStarted (Фиксация запущена)
  • CommitFailed (Сбой фиксации)
  • PendingPublication (Ожидание публикации)
  • Публикация
  • Опубликован
  • PublishFailed (Сбой публикации)
  • PreProcessing (Предварительная обработка)
  • PreProcessingFailed (Сбой предварительной обработки)
  • Сертификация
  • CertificationFailed (Сбой сертификации)
  • Выпуск
  • ReleaseFailed (Сбой выпуска)
statusDetails object Содержит дополнительные сведения о состоянии отправки, включая сведения об ошибках. Дополнительные сведения см. в разделе Ресурс сведений о состоянии.

Коды ошибок

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

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