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

Фиксация отправки тестового пакета

  • Статья

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

Дополнительные сведения о том, как операция фиксации вписывается в процесс создания отправки тестового пакета с помощью API отправки в Microsoft Store, см. в статье "Управление отправкой тестового пакета".

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

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

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

Запросить

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

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

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

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

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

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

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

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

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

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

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

Response

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

{
  "status": "CommitStarted"
}

Текст ответа

Значение Тип Описание
статус строка Состояние отправки. Это может быть одно из следующих значений:
  • нет
  • Отмененные
  • ОжиданиеCommit
  • CommitStarted
  • CommitFailed
  • Ожидание публикации
  • Публикация
  • Опубликованные
  • PublishFailed
  • Предварительная обработка
  • PreProcessingFailed
  • Сертификация
  • CertificationFailed
  • Выпуск
  • ReleaseFailed

Коды ошибок

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

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