Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Użyj interfejsów API sprzętu firmy Microsoft, aby programistycznie wykonywać zapytania i tworzyć zgłoszenia dla produktów sprzętowych w koncie Partner Center organizacji. Te interfejsy API są przydatne, jeśli twoje konto zarządza wieloma produktami i chcesz zautomatyzować i zoptymalizować proces przesyłania tych zasobów. Te interfejsy API używają identyfikatora Entra firmy Microsoft (Microsoft Entra ID) do uwierzytelniania wywołań z aplikacji lub usługi.
Tylko konta należące do programu Hardware Partner Center mogą korzystać z interfejsów API do zarządzania sprzętem. Oto kompleksowa procedura korzystania z interfejsu API sprzętu firmy Microsoft:
Wypełnij wymagania wstępne w następnej sekcji.
Uzyskaj token dostępu microsoft Entra ID przed wywołaniem metody w interfejsie API sprzętu firmy Microsoft. Po utworzeniu tokenu masz 60 minut na wykorzystanie go w wywołaniach interfejsu API przesyłania do sklepu Microsoft Store zanim token wygaśnie. Po wygaśnięciu tokenu możesz wygenerować nowy.
Wywołaj interfejs API sprzętu firmy Microsoft.
Spełnij wymagania wstępne dotyczące korzystania z interfejsu API sprzętu firmy Microsoft
Przed rozpoczęciem pisania kodu w celu wywołania interfejsu API sprzętu firmy Microsoft należy spełnić następujące wymagania wstępne:
You (or your organization) must have a Microsoft Entra ID directory and you must have Global administrator permission for the directory. Jeśli korzystasz już z platformy Microsoft 365 lub innych usług biznesowych, masz już katalog Microsoft Entra ID. W przeciwnym razie możesz utworzyć nowy Microsoft Entra ID w Partner Center bez dodatkowych opłat.
Jeśli aplikacja Microsoft Entra ID jeszcze nie istnieje, musisz utworzyć jedną.
Musisz skojarzyć aplikację Microsoft Entra ID z kontem Centrum partnerskiego i przypisać mu rolę menedżera.
Zbierz identyfikator dzierżawcy aplikacji Microsoft Entra ID, identyfikator klienta i klucz. Pamiętaj, aby wydrukować lub skopiować te informacje o kluczu, ponieważ nie będzie można uzyskać do niego dostępu ponownie po opuszczeniu strony tworzenia klucza.
Przypisywanie odpowiednich ról sprzętu do aplikacji Microsoft Entra ID
Po spełnieniu wymagań wstępnychprzypisz odpowiednie role, aby aplikacja Microsoft Entra ID mogła tworzyć przesłania i etykiety wysyłkowe oraz zarządzać nimi.
From Partner Center, select the gear icon (near the upper right corner of the dashboard) and then select Developer settings. In the Settings menu, select Users.
On the Users page, select Microsoft Entra ID applications and the Microsoft Entra ID application that represents the app or service you use to access submissions for your Partner Center account.
On this page, under Roles, select Hardware.
Select Driver Submitter, Shipping Label owner, and if available, Shipping Label promoter. dowiedz się więcej o tych rolach
Uzyskaj token dostępu Microsoft Entra ID
Before you call any of the methods in the Microsoft Hardware API, you must first obtain a Microsoft Entra ID access token that you pass to the Authorization header of each method in the API. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu możesz odświeżyć token, aby móc nadal używać go w kolejnych wywołaniach interfejsu API. Aby uzyskać token dostępu, postępuj zgodnie z instrukcjami w Service to Service to Service Calls Using Client Credentials (Wywołania usługi do usługi przy użyciu poświadczeń klienta) w celu wysłania żądania HTTP POST do punktu końcowego https://login.microsoftonline.com/<tenant_id>/oauth2/token. Oto przykładowe żądanie.
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com
For the tenant_id value in the POST URI and the client_id and client_secret parameters, specify the tenant ID, client ID, and the key for your application that you retrieved from Partner Center in the previous section. For the resource parameter, you must specify https://manage.devcenter.microsoft.com.
Po wygaśnięciu tokenu dostępu możesz go odświeżyć, postępując zgodnie z instrukcjami w Odświeżanie tokenów dostępu.
Korzystanie z interfejsu API sprzętu firmy Microsoft
Po utworzeniu tokenu dostępu microsoft Entra ID można wywołać metody w interfejsie API sprzętu firmy Microsoft. Interfejs API zawiera wiele metod pogrupowanych w scenariusze. Aby utworzyć lub zaktualizować zgłoszenia, zazwyczaj wywołujesz wiele metod w interfejsie sprzętu API firmy Microsoft w określonej kolejności. Aby uzyskać informacje o poszczególnych scenariuszach i składni każdej metody, zobacz artykuły w poniższej tabeli.
| Scenario | Description |
|---|---|
| Drivers | Pobieranie, tworzenie i aktualizowanie sterowników zarejestrowanych na koncie Centrum partnerskiego. Aby uzyskać więcej informacji na temat tych metod, zobacz następujące artykuły: |
Code sample
Poniższy przykładowy kod zawiera kompletne wstępnie utworzone rozwiązanie utworzone przez zespół ds. urządzeń Microsoft Surface i Devices:
More help
If you have questions about the Microsoft Store submission API or need assistance managing your submissions with this API, visit the support page and request help.