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

  • Статья

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

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

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

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

Запрос

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

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

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

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

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

Имя Тип Описание Обязательно
applicationId строка Код продукта в Магазине для приложения, по которому требуется получить данные о тестовых пакетах. Дополнительные сведения о коде продукта в Магазине см. в разделе Просмотр сведений об идентификации приложения. Да
top INT Число элементов, возвращаемых в запросе (т. е., количество возвращаемых тестовых пакетов). Если количество тестовых пакетов у вашей учетной записи больше значения, указанного в запросе, текст ответа будет содержать относительный путь URI, который можно добавить в URI метода, чтобы запросить следующую страницу данных. Нет
skip INT Число элементов, которые требуется пропустить в запросе перед возвратом оставшихся элементов. Используйте этот параметр для постраничного перемещения по наборам данных. Например, если задано 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 строка При наличии дополнительных страниц данных эта строка содержит относительный путь, который можно добавить к базовому URI https://manage.devcenter.microsoft.com/v1.0/my/ запроса, чтобы запросить следующую страницу данных. Например, если для параметра top в тексте исходного запроса задано значение 2, но приложение содержит 4 тестовых пакета, тело ответа будет содержать значение @nextLinkapplications/{applicationid}/listflights/?skip=2&top=2, которое указывает, что можно вызвать https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 для запроса следующих 2 тестовых пакетов.
значение array Массив объектов, которые предоставляют сведения о тестовых пакетах для указанного приложения. Дополнительные сведения о данных в каждом объекте см. в разделе Ресурс тестируемой возможности.
totalCount INT Общее количество строк в данных результата запроса (т. е., общее количество тестовых пакетов для указанного приложения).

Коды ошибок

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

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