Продление ключа идентификатора Microsoft Store
Используйте этот метод для продления ключа Microsoft Store. Если вы создаёте ключ идентификатора для Microsoft Store, он будет действителен в течение 30 дней. Перед истечением срока действия ключа его можно использовать для пересогласования нового ключа с помощью этого метода.
Библиотека Microsoft.StoreServices предоставляет функциональные возможности этого метода с помощью API UserStoreId.RefreshStoreId.
Заметка
Ранее ключи Microsoft Store имели более длительное время существования, и в некоторых случаях можно было продлить после истечения срока действия ключа. Теперь разработчики должны ожидать возможность возобновления ключей на протяжении их срока действия и следить за датой истечения, чтобы продлить ключи до их истечения.
Важно
Хотя ключи Microsoft Store могут быть продлены до истечения срока их действия, ключи могут быть отозваны до их истечения срока действия в ответ на проблемы безопасности. Поэтому ваши службы должны обрабатывать ситуацию, когда попытка обновления завершается сбоем из-за AuthenticationTokenInvalid. В этом случае необходимо создать новый ключ Microsoft Store для пользователя на клиенте или метод, используемый для создания исходного ключа Microsoft Store.
Необходимые условия
Чтобы использовать этот метод, вам потребуется:
- Токен доступа Entra ID, содержащий значение URI аудитории
https://onestore.microsoft.com/.default. - Истекший ключ идентификатора Microsoft Store, который был создан из клиентского кода вашего приложения.
Для получения дополнительной информации см. статью Управление правами на продукты из службы.
Просьба
Синтаксис запроса
| Тип ключа | Метод | URI запроса |
|---|---|---|
| Коллекции | ПОСТ | https://collections.mp.microsoft.com/v6.0/b2b/keys/renew |
| Покупка | ОПУБЛИКОВАТЬ | https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew |
Заголовок запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Хозяин | струна | Необходимо задать значение collections.mp.microsoft.com или purchase.mp.microsoft.com. |
| Длина содержимого | число | Длина текста запроса. |
| Тип контента | струна | Указывает тип запроса и ответа. В настоящее время единственным поддерживаемым значением является application/json. |
Текст запроса
| Параметр | Тип | Описание | Обязательно |
|---|---|---|---|
| serviceTicket | струна | Токен доступа для Entra ID. | Да |
| ключ | струна | Истекший ключ идентификатора Microsoft Store. | Да |
Пример запроса
POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com
{
"serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb….",
"Key": "eyJ0eXAiOiJKV1QiLCJhbG…."
}
Ответ
Содержимое ответа
| Параметр | Тип | Описание |
|---|---|---|
| ключ | струна | Обновленный ключ Microsoft Store, который можно использовать в будущих вызовах API коллекций Microsoft Store или API покупки. |
Пример ответа
HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT
{
"key":"eyJ0eXAi….."
}
Коды ошибок
| Код | Ошибка | Код внутренней ошибки | Описание |
|---|---|---|---|
| 401 | Несанкционированный | Недействительный токен аутентификации | Маркер доступа Entra ID или ключ Microsoft Store, которые обновляются, недопустимы. В некоторых случаях детали ServiceError будут содержать больше информации, например, когда срок действия токена истек или отсутствует утверждение. |
| 401 | Несанкционированный | НесогласованныйИдентификаторКлиента | Утверждение clientId в ключе идентификатора Microsoft Store и утверждение appid в токене доступа Entra ID не соответствуют друг другу. |