Odnawianie klucza identyfikatora sklepu Microsoft Store
Użyj tej metody, aby odnowić klucz sklepu Microsoft Store. Podczas generowania klucza identyfikatora sklepu Microsoft Storeklucz jest ważny przez 30 dni. Przed wygaśnięciem klucza można użyć go do ponownego negocjowania nowego klucza przy użyciu tej metody.
Biblioteka Microsoft.StoreServices udostępnia funkcjonalność tej metody za pośrednictwem interfejsu API UserStoreId.RefreshStoreId.
Notatka
Wcześniej klucze sklepu Microsoft Store miały dłuższy okres istnienia i w niektórych przypadkach można było je odnowić po wygaśnięciu klucza. Teraz deweloperzy powinni oczekiwać, że klucze będą odnawialne tylko w okresie ich istnienia i powinny zanotować datę wygaśnięcia kluczy, aby odnowić je przed wygaśnięciem.
Ważny
Mimo że klucze sklepu Microsoft Store można odnowić przed ich wygaśnięciem, klucze mogą zostać odwołane przed datą wygaśnięcia w odpowiedzi na obawy dotyczące zabezpieczeń. W związku z tym usługi powinny obsługiwać przypadek, w którym próba odnowienia kończy się niepowodzeniem z komunikatem AuthenticationTokenInvalid. W takim przypadku należy wygenerować nowy klucz sklepu Microsoft Store dla użytkownika na kliencie lub metodę użytą do wygenerowania oryginalnego klucza sklepu Microsoft Store.
Warunki wstępne
Aby użyć tej metody, potrzebne są następujące elementy:
- Token dostępu identyfikatora Entra, który ma wartość URI odbiorcy
https://onestore.microsoft.com/.default. - Wygasły klucz identyfikatora sklepu Microsoft Store, który został wygenerowany na podstawie kodu po stronie klienta w Twojej aplikacji.
Aby uzyskać więcej informacji, zobacz Zarządzaj uprawnieniami do produktów z poziomu usługi.
Prośba
Składnia żądania
| Typ klucza | Metoda | Identyfikator URI żądania |
|---|---|---|
| Zbiory | POST | https://collections.mp.microsoft.com/v6.0/b2b/keys/renew |
| Zakup | POST | https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew |
Nagłówek żądania
| Nagłówek | Typ | Opis |
|---|---|---|
| Gospodarz | struna | Musi być ustawione na wartość collections.mp.microsoft.com lub purchase.mp.microsoft.com. |
| Długość zawartości | liczba | Długość treści żądania. |
| Typ zawartości | struna | Określa typ żądania i odpowiedzi. Obecnie jedyną obsługiwaną wartością jest application/json. |
Treść żądania
| Parametr | Typ | Opis | Wymagane |
|---|---|---|---|
| serviceTicket | struna | Token dostępu Entra ID. | Tak |
| klucz | struna | Wygasły klucz identyfikatora sklepu Microsoft Store. | Tak |
Przykład żądania
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…."
}
Odpowiedź
Treść odpowiedzi
| Parametr | Typ | Opis |
|---|---|---|
| klucz | struna | Odświeżony klucz dostępu do sklepu Microsoft Store, który może być używany w przyszłych wywołaniach interfejsu API kolekcji Microsoft Store lub interfejsu API zakupów. |
Przykład odpowiedzi
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….."
}
Kody błędów
| Kod | Błąd | Kod błędu wewnętrznego | Opis |
|---|---|---|---|
| 401 | Nieautoryzowany | Token uwierzytelniający jest nieważny | Token dostępu entra ID lub odnawiany klucz sklepu Microsoft Store są nieprawidłowe. W niektórych przypadkach szczegóły błędu ServiceError zawierają więcej informacji, na przykład gdy token wygasł lub brakuje roszczenia appid. |
| 401 | Nieautoryzowany | NiespójnyIdentyfikatorKlienta | Oświadczenie clientId w kluczu identyfikatora Microsoft Store i oświadczenie appid w tokenie dostępu Entra ID nie zgadzają się ze sobą. |