Partager via

Gérer les soumissions de produits

  • Article

Utilisez les méthodes suivantes dans les API de hardware Microsoft pour gérer les soumissions de vos produits et les faire signer par Microsoft. Pour une introduction aux Microsoft Hardware APIs, y compris les conditions préalables à l’utilisation de l’API, veuillez consulter API de tableau de bord matériel.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Méthodes pour gérer les soumissions de produits.

Method URI Description
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Obtenir l’état/les données d’un produit spécifique
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Obtenir l’état/les données d’une soumission spécifique d’un produit
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Créer un nouveau produit
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Créer une nouvelle soumission pour un produit
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Valider une soumission de produit

Créer et soumettre un produit pour signature

  1. Remplissez toutes les conditions préalables pour les API matérielles de Microsoft.

  2. Obtenez un token d’accès Microsoft Entra ID. Vous devez transmettre ce jeton d’accès aux méthodes dans l’API de soumission au Microsoft Store. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

  3. Créez un nouveau produit en exécutant la méthode suivante dans l’API de hardware Microsoft. Cette méthode crée un nouveau produit en cours et vous permet de soumettre des packages pour ce produit.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

    Le corps de la réponse contient une ressource de produit qui inclut l’ID de ce produit.

  4. Créez une soumission pour ce produit en exécutant la méthode suivante dans l’API de hardware Microsoft. Utilisez le ProductID créé à l'étape précédente.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/

    Le corps de la réponse contient une ressource de soumission qui inclut l’ID de la soumission, l’URI de signature d’accès partagé (SAS) pour charger le package de produit (pilote) de la soumission vers le Stockage Blob Azure. [REMARQUE] > Un URI SAS permet d’accéder à une ressource sécurisée dans le stockage Azure sans clés de compte. Pour des informations générales sur les URI SAS et leur utilisation avec Azure Blob Storage, consultez Octroi d'un accès limité aux ressources Azure Storage à l'aide de signatures d'accès partagé (SAS).

  5. Chargez votre package dans le Stockage Blob Azure à l’emplacement spécifié par l’URI SAS à l’étape précédente. L’exemple de code C# suivant montre comment télécharger une package vers le Stockage Blob Azure à l’aide de la classe CloudBlockBlob dans la bibliothèque Azure Storage Blobs pour .NET. Cet exemple suppose que le package est déjà écrit dans un objet stream.

    string sasUrl = "<SAS URL from Hardware API>";
Azure.Storage.Blobs.Specialized.BlockBlobClient blockBlobClient =
    new Azure.Storage.Blobs.Specialized.BlockBlobClient(new System.Uri(sasUrl));
string filePath = "<Path to HLK package>";
using (FileStream fileStream = File.OpenRead(filePath))
{ 
    await blockBlobClient.UploadAsync(fileStream);
}

  6. Validez la soumission du produit à l’aide de la méthode suivante. Cette méthode alerte le Centre de développement matériel que vous avez terminé la soumission de votre produit et que la validation commence pour la soumission.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit

  7. Vérifiez l’état de validation en exécutant la méthode suivante pour obtenir l’état de la soumission du produit.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}

    Pour confirmer l’état de la soumission, vérifiez la valeur commitStatus dans le corps de la réponse. Cette valeur doit passer de CommitReceived à CommitComplet, si la requête réussit, ou CommitFailed en cas d’erreurs dans la requête.

    Remarque

    La page de recherche principale s’actualise environ toutes les 10 minutes. Pour afficher tous vos résultats à mesure que vous les créez, cliquez sur Page Liste des pilotes (tous), en haut de la page Pilotes de l’Espace partenaires. Bien que la page mette un certain temps à se charger et à effectuer le traitement si vous avez beaucoup de soumissions, les soumissions réussies et non réussies devraient être listées lorsqu’elle est chargée. Pour en savoir plus, consultez Rechercher une soumission de hardware.

Exemple de code

L’exemple de code suivant montre comment utiliser l’API de hardware Microsoft :

Ressources de données

Les méthodes des API de hardware Microsoft pour la création et la gestion des données de produits utilisent les ressources de données JSON suivantes :

Voir aussi