Получение приложения

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

Предпосылки

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

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

Просьба

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

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

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

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

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

Имя Тип Описание
applicationId струна Обязательное. Идентификатор магазина для получения приложения. Для получения дополнительных сведений об идентификаторе магазина см. Просмотр данных об идентичности приложения.

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

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

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

В следующем примере показано, как получить информацию о приложении со значением идентификатора Store 9NBLGGH4R315.

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

Ответ

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

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": false
}

Коды ошибок

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

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