API voor hardware dashboards
Gebruik de Microsoft Hardware-API's om programmatisch query's uit te voeren en verzendingen te maken voor hardwareproducten binnen het Partnercentrum-account van uw organisatie. Deze API's zijn handig als uw account veel producten beheert en u het indieningsproces voor deze assets wilt automatiseren en optimaliseren. Deze API's gebruiken Microsoft Entra ID (Microsoft Entra ID) om de aanroepen van uw app of service te verifiëren.
Alleen accounts die deel uitmaken van het Hardware Partner Center-programma kunnen de API's van het hardwaredashboard gebruiken. Hier volgt het end-to-end-proces voor het gebruik van de Microsoft Hardware-API:
Voltooi de vereisten in de volgende sectie.
Haal een Microsoft Entra ID-toegangstoken op voordat u een methode aanroept in de Microsoft Hardware-API. Nadat u een token hebt, hebt u 60 minuten om het te gebruiken in aanroepen naar de Microsoft Store-indienings-API voordat het token verloopt. Nadat het token is verlopen, kunt u een nieuw token genereren.
Roep de Microsoft Hardware-API aan.
Voltooi de vereisten voor het gebruik van de Microsoft Hardware-API
Voordat u begint met het schrijven van code om de Microsoft Hardware-API aan te roepen, moet u aan de volgende vereiste vereisten voldoen:
U (of uw organisatie) moet een Microsoft Entra ID-directory hebben en u moet een globale-beheerdersmachtiging voor de directory hebben. Als u al Microsoft 365 of andere zakelijke services van Microsoft gebruikt, hebt u al de Microsoft Entra ID-directory. Anders kunt u een nieuwe Microsoft Entra-id maken in partnercentrum zonder extra kosten.
Als er nog geen Microsoft Entra ID-toepassing bestaat, moet u eenmaken.
U moet een Microsoft Entra ID-toepassing koppelen aan uw Partnercentrum-account en deze de Manager-rol toewijzen.
Verzamel uw tenant-id van de Microsoft Entra ID-toepassing, client-id en sleutel. Zorg ervoor dat u deze sleutelgegevens afdrukt of kopieert, omdat u deze niet meer kunt openen nadat u de pagina voor het maken van de sleutel hebt verlaten.
De juiste hardwarerollen toewijzen aan uw Microsoft Entra ID-toepassing
Nadat de vereistenhebt voltooid, wijst u de juiste rollen toe, zodat de Microsoft Entra ID-toepassing verzendingen en verzendlabels kan maken en beheren.
Selecteer in Partnercentrum het tandwielpictogram (in de rechterbovenhoek van het dashboard) en selecteer vervolgens Instellingen voor ontwikkelaars. Selecteer in het menu InstellingenGebruikers.
Selecteer op de pagina GebruikersMicrosoft Entra ID-toepassingen en de Microsoft Entra ID-toepassing die de app of service vertegenwoordigt die u gebruikt voor toegang tot inzendingen voor uw PartnerCentrum-account.
Selecteer op deze pagina onder Rollende optie Hardware.
Selecteer Driver Indiener, Verzendlabeleigenaaren, indien beschikbaar, Verzendlabelpromoter. Meer informatie over deze rollen
Een Microsoft Entra ID-toegangstoken verkrijgen
Voordat u een van de methoden aanroept in de Microsoft Hardware-API, moet u eerst een Microsoft Entra ID-toegangstoken verkrijgen dat u doorgeeft aan de Authorization header van elke methode in de API. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u het token vernieuwen, zodat u het kunt blijven gebruiken in verdere aanroepen naar de API. Als u het toegangstoken wilt verkrijgen, volgt u de instructies in Service-to-Service-communicatie door gebruik te maken van klantgegevens om een HTTP POST naar het https://login.microsoftonline.com/<tenant_id>/oauth2/token-eindpunt te verzenden. Hier volgt een voorbeeldaanvraag.
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
Geef voor de tenant_id waarde in de POST-URI en de parameters client_id en client_secret de tenant-id, client-id en de sleutel op voor uw toepassing die u in de vorige sectie hebt opgehaald uit het Partnercentrum. Voor de parameter resource moet u https://manage.devcenter.microsoft.comopgeven.
Nadat uw toegangstoken is verlopen, kunt u het vernieuwen door de instructies te volgen in De toegangstokens vernieuwen.
De Microsoft Hardware-API gebruiken
Nadat u een Microsoft Entra ID-toegangstoken hebt, kunt u methoden aanroepen in de Microsoft Hardware-API. De API bevat veel methoden die zijn gegroepeerd in scenario's. Als u verzendingen wilt maken of bijwerken, roept u doorgaans meerdere methoden aan in de Microsoft Hardware-API in een specifieke volgorde. Zie de artikelen in de volgende tabel voor informatie over elk scenario en de syntaxis van elke methode.
| Scenario | Beschrijving |
|---|---|
| Stuurprogramma's | Stuurprogramma's ophalen, maken en bijwerken die zijn geregistreerd bij je Partner Center-account. Zie de volgende artikelen voor meer informatie over deze methoden: |
Codevoorbeeld
Het volgende codevoorbeeld biedt een volledige end-to-end vooraf samengestelde oplossing die is gemaakt door het Microsoft Surface- en Apparaten-team:
Meer hulp
Als u vragen hebt over de Microsoft Store-inzendings-API of hulp nodig hebt bij het beheren van uw inzendingen met deze API, gaat u naar de ondersteuningspagina en vraagt u hulp aan.